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 -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

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`	Print
`Ctrl+W` / `Ctrl+F4`	Close tab
`Ctrl+Tab` / `Ctrl+Shift+Tab`	Switch tabs
`Mouse Wheel`	Scroll
`Ctrl+Mouse Wheel`	Zoom
`F5`	Reload

Requirements

Build from Source

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

License

MIT