mdnav

ターミナル上でMarkdownファイル群をWiki的にブラウジングできるTUIツール。

npx mdnav [directory]

スクリーンショット

インストール

# グローバルインストール
npm install -g mdnav

# または npx で即試用
npx mdnav

使い方

mdnav                   # カレントディレクトリを開く
mdnav ~/my-vault        # 指定ディレクトリを開く
mdnav --help
mdnav --version

キーバインド

| キー | 操作 | |------|------| | j / ↓ | ツリー移動 / ビューアスクロール下 | | k / ↑ | ツリー移動 / ビューアスクロール上 | | h / ← | ビューア横スクロール左 | | l / → | ビューア横スクロール右 | | d | ビューア半ページ下 | | u | ビューア半ページ上 | | Enter | ファイルを開く / フォルダの折り畳み・展開 | | b | ファイルツリーの表示 / 非表示 | | Tab | ツリー / ビューア切替 | | f | リンク一覧を表示（ビューア内） | | [ | 閲覧履歴を戻る | | ] | 閲覧履歴を進む | | q | 終了 |

リンクジャンプ

ビューアで l を押すとファイル内のリンク一覧が表示されます。 j/k で選択 → Enter でジャンプ。Esc でキャンセル。

対応フォーマット:

• Markdown リンク: [text](path.md)
• Wiki リンク: [[pagename]] / [[pagename|display text]]

競合との比較

| ツール | 複数ファイル | リンクジャンプ | TUI | |--------|------------|--------------|-----| | mdnav | ✅ | ✅ | ✅ | | glow | ❌（単ファイル） | ❌ | ✅ | | zk | ✅ | ❌ | ❌ |

ライセンス

MIT