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

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

This is the beginning of the README. Read the rest at the original. Read the full README ↗