MarkdownPointer MCP server
Enables AI clients to open, navigate, export, and import Markdown documents and presentation files.
Also known as yotsuda/MarkdownPointer
- Stars
- 1
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Jun 10, 2026
- License
- MIT
What is MarkdownPointer MCP?
MarkdownPointer enables AI clients to open, navigate, export, and import Markdown documents and presentation files. It exposes 8 tools, such as show_markdown, get_status, slide_control.
Summary generated from the project's README
About MarkdownPointer MCP server
Navigating and editing Markdown documents through precise element referencing is what MarkdownPointer enables for developers using AI clients. By rendering Markdown files, users can click on specific headings, code blocks, table cells, Mermaid diagram nodes, or KaTeX math to copy a filepath and line number reference. This reference allows an AI to identify the exact location of content for editing or verification tasks.
Running on Windows with PowerShell 7 and the .NET 10 Desktop Runtime, this server connects to Claude Desktop or Claude Code to provide direct document control. It offers tools like show_markdown to scroll to specific lines, slide_control for navigating reveal.js presentations, and export_document to convert files into .pptx or .docx formats. Users can also import existing PowerPoint or Word files back into Markdown while extracting images. The system supports live reloading and allows for window management such as undocking tabs or pinning the viewer to stay on top of other applications.
What you can do with it
- 1Targeted content editingDirect an AI to modify a specific paragraph or code block by providing a filepath and line reference.
- 2Presentation managementControl slide navigation and extract content from presentation files using an AI client.
- 3Reverse document engineeringTransform existing PowerPoint or Word documents into Markdown format with image extraction.
Written from the project's README. Every use case is checked against a quote from it.
MarkdownPointer MCP tools 8
Detected from the READMEshow_markdownget_statusslide_controlget_slide_infoget_slide_imageexport_documentimport_documenttag_asset
| show_markdown | — | |
| get_status | — | |
| slide_control | — | |
| get_slide_info | — | |
| get_slide_image | — | |
| export_document | — | |
| import_document | — | |
| tag_asset | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableyotsuda/markdownpointer is public and reachablegithub.com/yotsuda/markdownpointer ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-10github.com/yotsuda/markdownpointer ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubMarkdownPointer
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
git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1
License
MIT
MarkdownPointer MCP questions
What tools does MarkdownPointer MCP provide?
It exposes 8 tools, including show_markdown, get_status, slide_control, get_slide_info, get_slide_image.
How can I connect MarkdownPointer to Claude?
You can use the PowerShell commands Register-MdpToClaudeCode or Register-MdpToClaudeDesktop to connect the server to Claude Code or Claude Desktop.
What should I do if the MCP client fails to connect?
Ensure that the .NET 10 Desktop Runtime is installed on your system, as it is a requirement for the server to function.
Can the AI export documents to other formats?
Yes, the AI can export documents to .pptx using built-in tools or to .docx using Pandoc.