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 分