MarkdownPointer

io.github.yotsudaPublished by GitHub account yotsudav0.1.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & StorageMedia & Design

Overview

AI-generated overview

A Windows Markdown viewer whose MCP server lets an assistant open, navigate, export, and import documents by file and line reference.

What you can do
MarkdownPointer renders Markdown files and lets you click any element to copy a filepath:line reference for use in AI prompts. Its MCP server exposes tools to open files and scroll to a line, report window and tab state, control reveal.js slides, read slide content as text or PNG, export documents to pptx or docx, import docx or pptx back to Markdown with image extraction, and tag imported assets in an index file.
When to use it
Useful when you review or edit Markdown documents with an AI assistant and want it to jump to exact sections, slides, or diagram nodes instead of guessing locations. Also relevant if you need to convert between Markdown and PowerPoint or Word files from a chat prompt.
Requirements
Runs locally on Windows 10 or 11 only, as a desktop application. Needs PowerShell 7.4 or later and the .NET 10 Desktop Runtime, which is not bundled with Windows. Slide image capture requires PowerPoint. Docx export uses Pandoc. No accounts, API keys, or environment variables are declared.
Before you install
The server can open, export, and import documents, and import extracts images and writes an index file, so it modifies files on disk. Exports and imports write new files in your working folders. It is Windows desktop only and will not run on other platforms or in a browser.

Installation

In SourceWeft

  1. Open MarkdownPointer in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

[Image]     [Image]     [Image]

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.pptx (built-in Open XML), .docx (via Pandoc). Mermaid/SVG rendered as images
MCP ServerLet AI open, navigate, export documents, and generate/import PPTX

Install

In a PowerShell 7 console:

powershell
Install-Module MarkdownPointer

Quick Start

powershell
mdp .\README.md    # Open a filemdp .\docs\*.md    # Open multiple filesmdp                # 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:

powershell
Register-MdpToClaudeCode       # Claude CodeRegister-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

ToolDescription
show_markdownOpen files and scroll to a line
get_statusGet current window/tab state
slide_controlNavigate reveal.js slides
get_slide_infoGet slide shapes and content as text
get_slide_imageGet a slide as PNG image (requires PowerPoint)
export_documentExport to .pptx (built-in) or .docx (Pandoc)
import_documentImport .docx/.pptx to Markdown + extract images
tag_assetTag imported files and images in index.json

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

Build from Source
powershell
git clone https://github.com/yotsuda/MarkdownPointer.gitcd MarkdownPointer.\Build-Deploy.ps1

License

MIT

Source: README.md at commit b698ebc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts