MarkdownPointer
Markdown viewer for AI-assisted document review. Click any element to copy file path + line number.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
https://github.com/yotsuda/MarkdownPointer/releases/download/v0.1.1/MarkdownPointer-0.1.1-win-x64.mcpbDocumentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
| 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
Build from Source
git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1
License
MIT
Frequently asked questions
What is MarkdownPointer?
Markdown viewer for AI-assisted document review. Click any element to copy file path + line number.
How do I install MarkdownPointer?
Follow the installation steps in its documentation, shown on this page and in its repository.
Does MarkdownPointer need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is MarkdownPointer open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains MarkdownPointer?
It is published by yotsuda. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.