About MarkdownPointer
MarkdownPointer is a Windows Markdown viewer for document review, aimed at people working with AI on Markdown files. Clicking rendered content copies a file-and-line reference, and its MCP server can also open, navigate, import, and export documents.
Key features
- 01Copy file-and-line references from rendered elements
- 02Render Mermaid diagrams and KaTeX math
- 03Live reload and recent-file access
- 04Export to PPTX and DOCX
- 05Open, navigate, import, and export through MCP
Use cases
- 01Point an AI to a specific Markdown passage for edits
- 02Review diagrams or mathematical notation in Markdown
- 03Export Markdown reports to PPTX or DOCX
MCP support
Its MCP server exposes tools for opening files, navigating slides, checking viewer state, and importing or exporting documents.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMarkdownPointer
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.