Back to Directory/File Systems

MarkdownPointer

Markdown viewer for AI-assisted document review. Click any element to copy file path + line number.

File SystemsC#v0.1.1

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

FeatureDescription
Point & PromptClick any rendered element to copy filepath:line to clipboard
Mermaid DiagramsFlowchart, Sequence, Class, State, ER, Gantt, Pie, Git graph, Mindmap
KaTeX MathInline $...$ and block $$...$$
SVGEmbedded font support
Recent FilesQuick access with pin support
Tab Dock/UndockDrag tabs between windows or detach to a new window
Always on TopPin the window above other apps for reference
Live ReloadAuto-refresh on file changes
Export.docx / .pptx via Pandoc (Mermaid/SVG rendered as images)
MCP ServerLet Claude open, navigate, and export your documents

Install

In a PowerShell 7 console:

powershell
Install-Module MarkdownPointer

Quick Start

powershell
mdp .\README.md    # Open a file
mdp .\docs\*.md    # Open multiple files
mdp                # Just launch the viewer

MCP Server Setup

Connect MarkdownPointer to Claude Code so your AI can open and navigate documents directly.

Claude Code

powershell
claude mcp add mdp -s user -- "$(Get-MarkdownPointerMCPPath)"

Then just ask Claude:

  • "open README.md in mdp"
  • "show the report in mdp and scroll to line 50"
  • "export report.md to docx"

Claude Desktop

Run this in PowerShell to get the path for your environment:

powershell
Get-MarkdownPointerMCPPath -Escape

Then add to claude_desktop_config.json:

json
{
  "mcpServers": {
    "mdp": {
      "command": "<paste the output here>"
    }
  }
}

MCP Tools

ToolDescription
show_markdownOpen files and scroll to a line
get_statusGet current window/tab state
slide_controlNavigate reveal.js slides
export_documentExport to .docx / .pptx via Pandoc

Keyboard Shortcuts

ShortcutAction
Ctrl+OOpen file
Ctrl+FFind in page
Ctrl+GGo to line
Ctrl+PPrint
Ctrl+W / Ctrl+F4Close tab
Ctrl+Tab / Ctrl+Shift+TabSwitch tabs
Mouse WheelScroll
Ctrl+Mouse WheelZoom
F5Reload

Requirements

<details> <summary>Build from Source</summary>
powershell
git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1
</details>

License

MIT

Learn More