人と機械の両方に役立つ文書形式には、4つの条件が必要です
Markdownは最初の3つを満たします。残る1つは、文書が浅いあいだしか保たれません。
公開標準
誰でも使い、実装できる
✓ Markdown
機械可読
パーサーが正確に解釈
✓ Markdown
AI可読
LLMがそのまま読める
✓ Markdown
人間可読
文書が浅いあいだだけ
● 深さ1–2● 3–4● 5+
ツリーとして描くのは簡単です。
何も失わずに戻すのが難しいのです。
階層が深くなると、人はプレーンテキストから構造を読み取れなくなります。同じ構造をツリーで描けばすぐに読めるのに、です。しかしLLMが文書を書き換えた瞬間、以下の情報は静かに失われます。これを問題として扱う標準はまだありません。
ノードの同一性人が付けた注釈レイアウトレビュー履歴
インストール不要の単一HTML、2つのビュー
Mindmap Markdownの文書は、何もインストールせずに開ける単一のHTMLファイルとして描画されます。そのビューアはマインドマップとアウトラインの2つのビューを備えています。どのビューも単独では、あらゆる規模に対応できないからです。
マインドマップ
ひと目でわかる形階層が深いときに強いアウトライン
たどれる順序ノード数が多いときに強い適合性レベル
レベルは累積的です。実装は、自らが主張する最も高いレベルを明示します。
L0Read
適合する文書は普通のMarkdownです。既存のあらゆるMarkdownツールで階層が保たれます。
● すべてのMarkdownツール
L1Structure
文書→ツリー（lift）とツリー→文書（canonical projection）がそれぞれ一つに定まり、互いに逆関数になります。
● mindmapmdで実装
L2Round-trip
ツリー間の構造的なdiff・merge、文書全体なしで部分木を扱うこと。
● 規則は未作成
設計原則
それでもMarkdown
GitHubやObsidianなど、いま使っているエディタでそのまま開けます。導入コストはゼロから。
意味は文書に、表現はその横に
レイアウトとスタイルはサイドカーに置き、モデルに送るテキストには含めません。
検証できる適合性
確かめられない仕様は提案にすぎません。仕様とテストは同じソースから生成されます。
競合より相互運用
OPML、JSON Canvas、markmapなど既存形式のアダプターを先に作ります。
リポジトリ
spec公開
仕様と規範例
mindmapmdL1
参照実装：lift・canonical projection
conformance予定
テストスイート、ランナー、実装レジストリ
adapters予定
OPML・JSON Canvas・markmapとの相互運用