什么是 MarkdownPointer?
面向 AI 辅助文档审阅的 Markdown 查看器,可点击任意元素复制文件路径与行号,便于快速定位内容。
README
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:
<p align="center"> <img width="40%" valign="middle" alt="Image" src="https://github.com/user-attachments/assets/af06577f-4f7c-40cd-b76e-e3426fd36699" /> <img width="8%" valign="middle" alt="Image" src="https://github.com/user-attachments/assets/16b7d1ab-3799-421a-8d21-9ecdbc1ae66c" /> <img width="40%" valign="middle" alt="Image" src="https://github.com/user-attachments/assets/daea5945-af62-47f7-8f02-a0206611d8e7" /> </p>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
| Feature | Description |
|---|---|
| Point & Prompt | Click any rendered element to copy filepath:line to clipboard |
| Mermaid Diagrams | Flowchart, Sequence, Class, State, ER, Gantt, Pie, Git graph, Mindmap |
| KaTeX Math | Inline $...$ and block $$...$$ |
| SVG | Embedded font support |
| Recent Files | Quick access with pin support |
| Tab Dock/Undock | Drag tabs between windows or detach to a new window |
| Always on Top | Pin the window above other apps for reference |
| Live Reload | Auto-refresh on file changes |
| Export | .pptx (built-in Open XML), .docx (via Pandoc). Mermaid/SVG rendered as images |
| MCP Server | Let 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 -Escapeas 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
| Tool | Description |
|---|---|
show_markdown | Open files and scroll to a line |
get_status | Get current window/tab state |
slide_control | Navigate reveal.js slides |
get_slide_info | Get slide shapes and content as text |
get_slide_image | Get a slide as PNG image (requires PowerPoint) |
export_document | Export to .pptx (built-in) or .docx (Pandoc) |
import_document | Import .docx/.pptx to Markdown + extract images |
tag_asset | Tag imported files and images in index.json |
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Ctrl+O | Open file |
Ctrl+F | Find in page |
Ctrl+G | Go to line |
Ctrl+P | |
Ctrl+W / Ctrl+F4 | Close tab |
Ctrl+Tab / Ctrl+Shift+Tab | Switch tabs |
Mouse Wheel | Scroll |
Ctrl+Mouse Wheel | Zoom |
F5 | Reload |
Requirements
- Windows 10/11
- PowerShell 7.4+
- .NET 10 Desktop Runtime
git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1
License
MIT
常见问题
MarkdownPointer 是什么?
面向 AI 辅助文档审阅的 Markdown 查看器,可点击任意元素复制文件路径与行号,便于快速定位内容。
相关 Skills
文档共著
by anthropics
围绕文档、提案、技术规格、决策记录等写作任务,按上下文收集、结构迭代、读者测试三步协作共创,减少信息遗漏,写出更清晰、经得起他人阅读的内容。
✎ 写文档、方案或技术规格时容易思路散、信息漏,它用结构化共著流程帮你高效传递上下文、反复打磨内容,还能从读者视角做验证。
内部沟通
by anthropics
按公司常用模板和语气快速起草内部沟通内容,覆盖 3P 更新、状态报告、领导汇报、项目进展、事故复盘、FAQ 与 newsletter,适合需要统一格式的团队沟通场景。
✎ 按公司偏好的模板快速产出状态汇报、领导更新和 FAQ,既省去反复改稿,也让内部沟通更统一、更专业。
平面设计
by anthropics
先生成视觉哲学,再落地成原创海报、艺术画面或其他静态设计,输出 .png/.pdf,强调构图、色彩与空间表达,适合需要高完成度视觉成品的场景。
✎ 做海报、插画或静态视觉稿时,用它能快速产出兼顾美感与版式的PNG/PDF成品,原创设计更省心,也更适合规避版权风险。
相关 MCP Server
by nirholas
免费的加密新闻聚合 MCP,汇集 Bitcoin、Ethereum、DeFi、Solana 与 altcoins 资讯源。
by alisaitteke
用于Adobe Photoshop自动化的MCP server,让AI assistants直接控制Photoshop。
by ProfessionalWiki
让 Large Language Model 客户端无缝连接任意 MediaWiki 站点,可创建、更新、搜索页面,并通过 OAuth 2.0 安全管理内容。