Marxdown

Markdown を読むために、VS Code を開きたくない。

Marxdown は、Markdown を快適に読むことを中心に設計した Windows 向けの Markdown ビューアー／エディターです（macOS / Linux 版はプレビュー）。 .md を開いて読む。必要になったら、そのまま編集する。

⬇ Windows 版をダウンロード · macOS / Linux 版（プレビュー） · Web サイト · ガイド

無料・オープンソース（MIT）· Windows 10 / 11（x64）· macOS 14 以降 / Linux（プレビュー）

日本語 | English

なぜ Marxdown？

Markdown は、いたるところにあります。 README。設計書。議事録。AI にまとめてもらった調査。アーキテクチャの決定記録。

そして、.md を 1 つ読むためだけに IDE を立ち上げるのは、ときどき大げさに感じます。

Marxdown は、その瞬間のためのアプリです。 開いて、読んで、必要なら少し直して、閉じる。

VS Code は素晴らしい。Marxdown は役割が違う。

VS Code は、強力な開発環境です。 Marxdown は、開発環境までは要らない場面のためにあります。

Markdown を開いて読み、ついでに誤字を 1 つ直したい。それだけなら、Marxdown のほうが手数が少なく済みます。

• 開くと、エディターのタブではなく 読むための表示 になります
• ワークスペースの読み込みも、拡張機能の起動待ちもありません
• 一度起動するとタスクトレイで待機するため、次の marxdown README.md はすぐにタブで開きます
• 書くときのエディターは、VS Code と同じ Monaco です

コードを書くのは VS Code、それについて書かれたものを読むのは Marxdown。そういう併用を想定しています。

AI が生成した Markdown を読む

AI に設計、調査、議事録、レビューなどを頼むと、Markdown が返ってくることが増えました。 設計書、調査メモ、会議の要約、実装計画、コードレビュー、プロジェクトのドキュメント。

Markdown を書く時間より、読む時間のほうが長くなっています。 Marxdown は、そうして増えていく Markdown を「読む」ための場所として使えます。

marxdown docs/                          # エージェントが書き込んだフォルダーを、ファイル一覧と一緒に開く
llm "設計案を出して" | marxdown -        # コマンドの出力を、整った文書として読む

表・コード・数式・Mermaid の図も、そのまま表示します。 また、AI の出力は自分で書いていない Markdown なので、文書に埋め込まれたスクリプトは実行しません（プライバシーとセキュリティ）。

使ったときの見た目

特徴

読む

• 読むための表示で開く。 余白・行間・本文幅を整えたタイポグラフィで、長い文書も読みやすく表示します
• 開発者が書くものを、そのまま表示する。 表、シンタックスハイライト付きのコード、数式（KaTeX）、図（Mermaid）、GitHub のアラート（> [!NOTE]）、タスクリスト、脚注
• 迷わない。 アウトラインから見出しへ移動でき、プレビュー内も検索できます

すぐ開く

• ターミナルから開ける。 marxdown README.md と打てば、すぐに読み始められます。cmd.exe / PowerShell / Git Bash のどこからでも、プロンプトはすぐに戻ります
• 2 つ目からはタブで開く。 一度起動するとタスクトレイで待機します。待機中は CPU をほとんど使いません
• ダブルクリックでも開ける。 .md / .markdown に関連付けられ、フォルダーの右クリックメニューに「Marxdown で開く」が加わります

必要なときに書く

• 読むから書くまで、キー 1 つ。 Preview / Edit / Split を切り替えられます
• 保存しても、変えたところしか変わらない。 改行コード・BOM・末尾の改行も、開いたときのまま保ちます
• ファイルの変化に追従する。 ほかのアプリ（や AI エージェント）がファイルを書き換えると、自動で再読み込みします

フォルダーごと扱う

• フォルダーを開ける。 marxdown docs/ で、ファイル一覧と一緒に開きます
• 名前で探せる。 Ctrl+P でファイルを検索し、Ctrl+Shift+P のコマンドパレットからすべての操作を実行できます

長い文書を、快適に読むために

Markdown は、一瞬見るだけではなく、何分、何十分と読むことがあります。 だから、フォントや行間、本文幅にこだわっています。

• 本文とコードのフォント、文字サイズ、行間、本文幅、表の罫線を調整できます
• ライト / ダーク / Windows の設定に合わせる、から選べます
• 50 種類の組み込み配色 に加え、themes フォルダーに CSS ファイルを置くだけで自分の配色を追加できます

ほかにも

• 表示している文書を HTML / PDF として書き出せます
• marp: true を書いた文書は、Marp のスライドとして表示します
• 定義リスト、マーカー、上付き・下付き文字などは設定で有効にできます
• 画面の表示は日本語と英語に対応しています（既定では OS の表示言語に合わせます）
• 新しいバージョンが出ると、アプリ内でお知らせします

ほかのツールとの違い

どのツールも、それぞれの目的では優れています。この表は優劣ではなく、何を中心に作られているかの違いです。

	Marxdown	VS Code	Typora	Obsidian
中心にあるもの	Markdown ファイルを読むこと（と、ちょっとした編集）	コードを書いてデバッグすること	Markdown を書くこと（WYSIWYG）	リンクでつながるノートの知識ベース
ファイル 1 つをそのまま開く	✓	✓	✓	ファイルは保管庫（Vault）に置く
編集の方式	ソースのエディター（Monaco）と Preview / Split	ソースのエディターとプレビューの区画	WYSIWYG	ライブプレビュー・ソース・閲覧の表示
対応 OS	Windows（macOS・Linux はプレビュー）	Windows・macOS・Linux	Windows・macOS・Linux	Windows・macOS・Linux・モバイル
価格	無料・オープンソース（MIT）	無料	有料（買い切り。試用期間あり）	無料（商用ライセンスは任意）

長い文章を書くなら Typora、ノートのつながりを育てるなら Obsidian、コードベースの中で暮らすなら VS Code が合っています。 Marxdown は、目の前のファイルを開いて読むためのアプリです。

インストール

Windows

1. Releases から Marxdown_<バージョン>_x64-setup.exe をダウンロードします
2. 実行します。管理者権限は不要です（%LOCALAPPDATA%\Marxdown にインストールされます）
3. 最後の「ターミナルから marxdown コマンドを使えるようにしますか？」で 「はい」 を選びます

これで完了です。.md をダブルクリックするか、marxdown README.md と入力してください。

[!NOTE] インストーラーには現在コード署名をしていないため、SmartScreen の警告（「Windows によって PC が保護されました」）が表示されることがあります。 「詳細情報」→「実行」の順に選ぶと、インストールを続けられます。

新しいバージョンが出ると、アプリ内に通知が表示され、「更新して再起動」で入れ替わります。 変更内容は CHANGELOG にあります。

Windows 11 には標準で入っています。 入っていない環境（一部の Windows 10）では、インストール中に自動でダウンロードするため、インターネット接続が必要です。

/S で確認なしにインストールします。/ADDTOPATH を付けると、PATH にも追加します。 更新するときは、前回の選択を引き継ぎます。

.\Marxdown_<バージョン>_x64-setup.exe /S /ADDTOPATH

「設定 > アプリ > インストールされているアプリ」から Marxdown をアンインストールします。 ファイルの関連付けと PATH は元に戻ります。 設定と最近開いたファイルの履歴も削除する場合は、アンインストール画面で「アプリのデータを削除」にチェックを入れてください。

macOS / Linux 版（プレビュー）

macOS 版と Linux 版はプレビューです。 Releases のプレリリース（v0.4.0-beta.1 のような版）にだけ置いています。 自動では更新されません。新しい版は Releases から入れ直してください。 不具合は Issue で知らせてください。

1. Apple シリコンの Mac は Marxdown_<バージョン>_aarch64.dmg を、Intel の Mac は Marxdown_<バージョン>_x64.dmg をダウンロードします
2. 開いて、Marxdown を「アプリケーション」へドラッグします
3. 署名していないため、初回の起動は Gatekeeper が止めます。macOS 15 以降は、一度開こうとした後に「システム設定 > プライバシーとセキュリティ」の「このまま開く」を選びます。macOS 14 は、Finder で Marxdown を右クリックして「開く」を選びます
4. ターミナルから使うときは、marxdown のリンクを置きます

sudo ln -sf /Applications/Marxdown.app/Contents/MacOS/marxdown /usr/local/bin/marxdown

.md をダブルクリックで開くには、Finder で .md の「情報を見る」から「このアプリケーションで開く」を Marxdown にし、「すべてを変更」を選びます。

.deb（Ubuntu / Debian）は、そのまま marxdown コマンドとファイルマネージャーの「別のアプリケーションで開く」に入ります。

sudo apt install ./Marxdown_<バージョン>_amd64.deb
xdg-mime default Marxdown.desktop text/markdown   # .md の既定のアプリにする場合

.AppImage は実行権を付けて起動します。libfuse2（Ubuntu 24.04 では libfuse2t64）が要ります。 ターミナルから使うときは、~/.local/bin などへリンクを置きます。

chmod +x Marxdown_<バージョン>_amd64.AppImage
ln -sf "$PWD/Marxdown_<バージョン>_amd64.AppImage" ~/.local/bin/marxdown

既知の制約は次のとおりです。

• 自動で更新されません。 新しい版は Releases から入れ直してください
• macOS の初回の起動を Gatekeeper が止めます。 上の手順で開けます
• macOS では、✕ でウィンドウを閉じても Dock に残ります。 Dock のアイコンで戻り、⌘+Q で終了します。ショートカットの Ctrl は ⌘ に読み替えます（付け替えたキーは キーボードショートカット にあります）
• macOS の PDF の書き出しは、印刷ダイアログの「PDF として保存」で行います
• Linux のタスクトレイは、トレイを表示できるデスクトップ環境（KDE Plasma など）でだけ使えます。 拡張機能を入れていない GNOME では、✕ で終了します
• Wayland では、ウィンドウの位置を復元できず、タブを別のウィンドウへドラッグして移せません。 コマンドパレットの「メインウィンドウに戻す」は使えます
• Snap Layouts、タブを引き出している間の表示、フォルダーの右クリックメニューは Windows だけの機能です
• macOS で「書類」や「デスクトップ」を初めて開くと、OS の確認が出ます

コマンドライン

marxdown README.md                 # ファイルを開く
marxdown README.md CHANGELOG.md    # 複数のファイルをタブで開く
marxdown docs/                     # フォルダーをファイル一覧と一緒に開く
marxdown -m split notes.md         # 表示モードを指定して開く: preview | edit | split
llm "設計案を出して" | marxdown -   # 標準入力の内容を無題の文書として開く
marxdown --help

標準入力から開いた文書は、まだファイルとして保存されていません。残したいときは Ctrl+Shift+S（名前を付けて保存）で保存してください。 Windows PowerShell 5.1 からパイプで渡すと、ASCII 以外の文字が ? に置き換わります（PowerShell の仕様です）。PowerShell 7.4 以降では起きません。

[!TIP] ✕ でウィンドウを閉じても、Marxdown はタスクトレイで待機しています。次の marxdown がすぐに開くのはこのためです。 完全に終了するには、Ctrl+Q を押すか、タスクトレイのメニューから「終了」を選んでください。

主なショートカット

キー	動作
Ctrl+Shift+V	Preview と Edit を切り替える
Ctrl+</kbd>	Split（エディターとプレビューを左右に並べる）
Ctrl+P	フォルダー内のファイルを検索して開く
Ctrl+Shift+P	コマンドパレット
Ctrl+,	設定
Ctrl+Q	終了

macOS では Ctrl を ⌘ に読み替えます。 すべてのショートカットは キーボードショートカット、記法と設定の一覧は ガイド にあります。

プライバシーとセキュリティ

• ファイルは手元から出ない。 アカウント登録はなく、利用状況の送信（テレメトリ）もありません。文書をどこかへアップロードすることもありません
• オフラインで使える。 Mermaid の図や数式を含め、表示の処理はすべて手元で行います。ただし、文書の中に https:// の画像があれば、ブラウザと同じように表示のために取得します
• 更新の確認。 起動時とウィンドウを前面に出したときに、1 日 1 回まで GitHub の Releases に新しいバージョンを問い合わせます。開いているファイルの情報は含みません。設定の「新しいバージョンを自動で確認する」（update.autoCheck）で止められます
• 自分で書いていない Markdown を前提に作っている。 文書に埋め込まれたスクリプトは実行せず、リンクを踏んでもアプリ内で別のページへ移動しません。開いたファイルのフォルダーの外にあるファイルは、許可しない限り読み込みません

脆弱性の報告は SECURITY.md を参照してください。

速さについて

Marxdown は、起動時間の予算を決めて作っています。初回の起動は 600ms、タスクトレイで待機している状態からは 120ms が目標です。 使う側から見ると、フル IDE の初期化を待たずに Markdown を開けて、2 つ目以降のファイルはすぐにタブで現れる、ということです。

これは release ビルドに対する起動のベンチマーク（初回は pnpm bench:boot、待機中からは scripts/bench-startup.mjs --warm。どちらも起動の各段階の中央値を取る）で確かめている設計上の目標で、どの PC でもこの時間になることを保証するものではありません。 計測の方法は CONTRIBUTING.md にあります。

技術的な詳細

• アプリの土台: Tauri 2（Rust）と WebView2。単一インスタンス、タスクトレイ、文字コード・改行コード・BOM を保つファイルの読み書き
• UI: Svelte 5 と TypeScript
• Markdown の処理: markdown-it で変換し、DOMPurify でサニタイズしたうえで、厳しい Content Security Policy の下で表示
• エディター: Monaco。初めて編集するときに読み込む
• 遅延読み込み: エディター・Mermaid・KaTeX・シンタックスハイライトは必要になるまで読み込まない。起動に必要なバンドルの大きさは CI で予算を検査している

ビルド手順・検査・計測・コードの構成は CONTRIBUTING.md にあります。

フィードバック

不具合の報告と機能の要望は Issue で受け付けています。 毎日 Markdown を読む方からの「ここが引っかかる」という声は、特に参考になります。

ライセンス

MIT