MarkdownPointer について
MarkdownPointerは、AIとMarkdown文書をレビューする人向けのWindows用ビューアーです。表示要素をクリックするとファイルパスと行番号をコピーでき、MCPサーバーから文書の表示、移動、インポート、エクスポートも行えます。
主な機能
- 01表示要素からファイルパスと行番号をコピー
- 02Mermaid図とKaTeX数式を表示
- 03ライブリロードと最近使ったファイル
- 04PPTXとDOCXへのエクスポート
- 05MCP経由で文書の表示、移動、入出力
活用シーン
- 01AIにMarkdownの編集箇所を示す
- 02Markdown内の図や数式をレビューする
- 03Markdownレポートを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]
- この2つのセクションを入れ替えてください [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 がインストールされていない可能性があります。.NET 10 は Windows に含まれていません。インストールして、もう一度お試しください。
あとは 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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。