关于 MarkdownPointer
MarkdownPointer 是面向 Windows 的 Markdown 查看器,适用于与 AI 协作审阅文档的用户。点击渲染内容即可复制文件路径和行号;其 MCP 服务还可打开、导航、导入和导出文档。
主要功能
- 01点击内容复制文件路径和行号
- 02渲染 Mermaid 图表和 KaTeX 数学公式
- 03实时重新加载并访问最近文件
- 04导出为 PPTX 和 DOCX
- 05通过 MCP 打开、导航、导入和导出
适用场景
- 01将 Markdown 段落位置提供给 AI 进行修改
- 02审阅 Markdown 中的图表或数学公式
- 03将 Markdown 报告导出为 PPTX 或 DOCX
MCP 相关
其 MCP 服务提供打开文件、浏览幻灯片、查看查看器状态以及导入和导出文档的工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
MarkdownPointer
让 Markdown 写作随心而动。 指向任意内容,让 AI 帮你修改。
MarkdownPointer 会渲染你的 Markdown,并允许你点击任意元素——标题、代码块、表格单元格、Mermaid 图表节点、KaTeX 数学公式——复制 filepath:line 引用。将其粘贴到 AI 提示词中,AI 就能准确找到要查看的位置。
要更改节点颜色:
点击节点,将引用粘贴到提示词中,然后向 AI 提出要求——完成。
Color this node orange [c:\docs\architecture.md:6] mermaid node: mdp.exe
更多提示词示例:
- 检查本节的技术准确性 [ref]
- 交换这两个章节 [ref] [ref]
- 删除此内容 [ref]
- 简化这段文字 [ref]
- 在本节后添加代码示例 [ref]
- 修正这里的语法 [ref]
- 将本节翻译成日语 [ref]
功能
| 功能 | 描述 |
|---|---|
| 指向并提示 | 点击任意已渲染元素,将 filepath:line 复制到剪贴板 |
| Mermaid 图表 | 流程图、时序图、类图、状态图、ER 图、甘特图、饼图、Git 图、思维导图 |
| KaTeX 数学公式 | 行内公式 $...$ 和块级公式 $$...$$ |
| SVG | 支持嵌入字体 |
| 最近文件 | 快速访问,支持固定 |
| 标签页停靠/分离 | 在窗口间拖动标签页,或将其分离到新窗口 |
| 窗口置顶 | 将窗口固定在其他应用上方,方便参考 |
| 实时重新加载 | 文件更改时自动刷新 |
| 导出 | .pptx(内置 Open XML)、.docx(通过 Pandoc)。Mermaid/SVG 会渲染为图片 |
| MCP 服务 | 让 AI 打开、浏览和导出文档,以及生成/导入 PPTX |
安装
在 PowerShell 7 控制台中:
Install-Module MarkdownPointer
快速入门
mdp .\README.md # Open a file
mdp .\docs\*.md # Open multiple files
mdp # Just launch the viewer
MCP 服务设置
将 MarkdownPointer 连接到 Claude,让你的 AI 能直接打开和浏览文档。
在 PowerShell 7 中运行以下命令:
Register-MdpToClaudeCode # Claude Code
Register-MdpToClaudeDesktop # Claude Desktop
其他 MCP 客户端: 将
Get-MarkdownPointerMCPPath -Escape的输出添加为 MCP 客户端配置文件中的命令。
故障排除: 如果 MCP 客户端无法连接到服务,可能是未安装 .NET 10 Desktop Runtime。Windows 未附带 .NET 10——请安装后重试。
然后直接向 Claude 提问:
- “在 mdp 中打开 README.md”
- “在 mdp 中显示报告并滚动到第 50 行”
- “将 report.md 导出为 docx”
- “将 slides.md 导出为 pptx”
- “将 presentation.pptx 导入为 Markdown”
- “显示 slides.md 的第 3 张幻灯片”
MCP 工具
| 工具 | 描述 |
|---|---|
show_markdown | 打开文件并滚动到指定行 |
get_status | 获取当前窗口/标签页状态 |
slide_control | 浏览 reveal.js 幻灯片 |
get_slide_info | 以文本形式获取幻灯片形状和内容 |
get_slide_image | 将幻灯片作为 PNG 图片获取(需要 PowerPoint) |
export_document | 导出为 .pptx(内置)或 .docx(Pandoc) |
import_document | 将 .docx/.pptx 导入为 Markdown + 提取图片 |
tag_asset | 在 index.json 中为导入的文件和图片添加标签 |
键盘快捷键
| 快捷键 | 操作 |
|---|---|
Ctrl+O | 打开文件 |
Ctrl+F | 在页面中查找 |
Ctrl+G | 跳转到指定行 |
Ctrl+P | 打印 |
Ctrl+W / Ctrl+F4 | 关闭标签页 |
Ctrl+Tab / Ctrl+Shift+Tab | 切换标签页 |
Mouse Wheel | 滚动 |
Ctrl+Mouse Wheel | 缩放 |
F5 | 重新加载 |
Requirements
- Windows 10/11
- PowerShell 7.4+
- .NET 10 Desktop Runtime
Build from Source
git clone https://github.com/yotsuda/MarkdownPointer.git
cd MarkdownPointer
.\Build-Deploy.ps1
License
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。