MarkdownPointer

io.github.yotsuda由 GitHub 账号 yotsuda 发布v0.1.1更新于 Oct 24, 2026

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

已验证STDIO仅桌面效率与工作流文件与存储媒体与设计

概览

AI 生成的概览

一个 Windows 上的 Markdown 查看器，其 MCP 服务器让助手按文件与行号打开、导航、导出和导入文档。

可以做什么
MarkdownPointer 渲染 Markdown 文件，点击任意元素即可复制 filepath:line 引用，便于粘贴到 AI 提示中。其 MCP 服务器提供工具：打开文件并滚动到指定行、获取窗口与标签页状态、控制 reveal.js 幻灯片、以文本或 PNG 读取幻灯片内容、将文档导出为 pptx 或 docx、把 docx 或 pptx 导入为 Markdown 并提取图片，以及在索引文件中标记导入的素材。
适用场景
适合在借助 AI 助手审阅或修改 Markdown 文档时使用，让助手直接定位到具体章节、幻灯片或图表节点，而不必猜测位置。也适合需要在对话中把 Markdown 与 PowerPoint 或 Word 文件互相转换的场景。
运行要求
仅在 Windows 10 或 11 上作为桌面应用本地运行。需要 PowerShell 7.4 及以上版本，以及 .NET 10 Desktop Runtime，后者不随 Windows 提供。幻灯片截图功能需要 PowerPoint，docx 导出依赖 Pandoc。未声明任何账号、API 密钥或环境变量。
安装前请注意
该服务器可以打开、导出和导入文档，导入会提取图片并写入索引文件，因此会修改磁盘上的文件。导出和导入会在工作目录中生成新文件。仅支持 Windows 桌面，无法在其他平台或浏览器中运行。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MarkdownPointer，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：README.md，提交 b698ebc

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分