English Français العربية

MarkdownPointer

السجل الرسمي الإنتاجية

Markdown viewer for AI-assisted document review. Click any element to copy file path + line number.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

MCPB package https://github.com/yotsuda/MarkdownPointer/releases/download/v0.1.1/MarkdownPointer-0.1.1-win-x64.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MarkdownPointer
  2. Features
  3. Install
  4. Quick Start
  5. MCP Server Setup
  6. Keyboard Shortcuts
  7. Requirements
  8. License

MarkdownPointer

Vibe writing for Markdown. Point at anything, tell AI to fix it.

MarkdownPointer renders your Markdown and lets you click any element - headings, code blocks, table cells, Mermaid diagram nodes, KaTeX math - to copy a filepath:line reference. Paste it into your AI prompt, and the AI knows exactly where to look.

To change a node's color:

Click the node, paste the reference into your prompt, and ask the AI — done.

Color this node orange [c:\docs\architecture.md:6] mermaid node: mdp.exe

More prompt examples:

  • Verify this section for technical accuracy [ref]
  • Swap these two sections [ref] [ref]
  • Delete this [ref]
  • Simplify this paragraph [ref]
  • Add a code example after this section [ref]
  • Fix the grammar here [ref]
  • Translate this section to Japanese [ref]

Features

FeatureDescription
Point & PromptClick any rendered element to copy filepath:line to clipboard
Mermaid DiagramsFlowchart, Sequence, Class, State, ER, Gantt, Pie, Git graph, Mindmap
KaTeX MathInline $...$ and block $$...$$
SVGEmbedded font support
Recent FilesQuick access with pin support
Tab Dock/UndockDrag tabs between windows or detach to a new window
Always on TopPin the window above other apps for reference
Live ReloadAuto-refresh on file changes
Export.pptx (built-in Open XML), .docx (via Pandoc). Mermaid/SVG rendered as images
MCP ServerLet AI open, navigate, export documents, and generate/import PPTX

Install

In a PowerShell 7 console:

Install-Module MarkdownPointer

Quick Start

mdp .\README.md    # Open a file
mdp .\docs\*.md    # Open multiple files
mdp                # Just launch the viewer

MCP Server Setup

Connect MarkdownPointer to Claude so your AI can open and navigate documents directly.

Run these in PowerShell 7:

Register-MdpToClaudeCode       # Claude Code
Register-MdpToClaudeDesktop    # Claude Desktop

Other MCP clients: Add the output of Get-MarkdownPointerMCPPath -Escape as the command in your MCP client's configuration file.

Troubleshooting: If the MCP client fails to connect to the server, .NET 10 Desktop Runtime may not be installed. .NET 10 is not included with Windows — install it and try again.

Then just ask Claude:

  • "open README.md in mdp"
  • "show the report in mdp and scroll to line 50"
  • "export report.md to docx"
  • "export slides.md to pptx"
  • "import presentation.pptx to markdown"
  • "show me slide 3 of slides.md"
MCP Tools
ToolDescription
show_markdownOpen files and scroll to a line
get_statusGet current window/tab state
slide_controlNavigate reveal.js slides
get_slide_infoGet slide shapes and content as text
get_slide_imageGet a slide as PNG image (requires PowerPoint)
export_documentExport to .pptx (built-in) or .docx (Pandoc)
import_documentImport .docx/.pptx to Markdown + extract images
tag_assetTag imported files and images in index.json

Keyboard Shortcuts

ShortcutAction
Ctrl+OOpen file
Ctrl+FFind in page
Ctrl+GGo to line
Ctrl+PPrint
Ctrl+W / Ctrl+F4Close tab
Ctrl+Tab / Ctrl+Shift+TabSwitch tabs
Mouse WheelScroll
Ctrl+Mouse WheelZoom
F5Reload

Requirements

Build from Source

git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1

License

MIT

الأسئلة الشائعة

ما هو MarkdownPointer؟

Markdown viewer for AI-assisted document review. Click any element to copy file path + line number.

كيف أثبّت MarkdownPointer؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل يحتاج MarkdownPointer إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل MarkdownPointer مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MarkdownPointer؟

ينشره yotsuda. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.