Mindmap Markdown
🌐 KO
GitHub
Draft · 공개적으로 다듬는 중

인간과 AI가 같은 지식을
각자의 표현으로.

Mindmap Markdown은 인간과 AI가 같은 지식을 각자의 표현으로 다루기 위한 왕복 안정(round-trip stable) 마크다운 프로파일입니다.

문서 형식이 사람과 기계를 모두 감당하려면 네 가지가 필요합니다

마크다운은 앞의 셋을 만족합니다. 남은 하나는 문서가 얕을 때만 유지됩니다.

공개 표준
누구나 쓰고 구현
✓ Markdown
기계 판독
파서가 정확히 해석
✓ Markdown
AI 가독
LLM이 그대로 읽음
✓ Markdown
사람 가독
문서가 얕을 때만
● 깊이 1–2● 3–4● 5+
계층이 깊어질수록 사람만 구조를 잃습니다개념도 · 측정값 아님
123456문서 계층 깊이 →구조를 읽어내는 정도 →기계 · AI사람 · 트리로 볼 때사람 · 평문으로 볼 때Mindmap Markdown이 메우는 간극

트리로 그리는 것은 쉽습니다.
손실 없이 되돌리는 것이 어렵습니다.

계층이 깊어지면 사람은 평문에서 구조를 볼 수 없습니다. 같은 구조를 트리로 그리면 즉시 읽히는데도 말입니다. 그런데 LLM이 문서를 재작성하는 순간 아래 정보가 조용히 사라지며, 이를 문제로 다루는 표준은 아직 없습니다.

노드 정체성사람이 단 주석레이아웃검토 이력

설치 없는 단일 HTML, 두 개의 뷰

Mindmap Markdown 문서는 아무것도 설치할 필요 없는 단일 HTML 파일로 렌더링되며, 그 뷰어는 마인드맵과 아웃라인 두 뷰를 함께 제공합니다. 어떤 단일 뷰도 모든 규모에서 작동하지 않기 때문입니다.

마인드맵

한눈에 보는 형태깊이가 깊을 때 강함

아웃라인

탐색 가능한 순서노드 수가 많을 때 강함

적합성 수준

수준은 누적됩니다. 구현은 자신이 주장하는 가장 높은 수준을 밝힙니다.

L0Read

적합한 문서는 평범한 마크다운입니다. 기존 모든 마크다운 도구에서 계층이 유지됩니다.

● 모든 마크다운 도구
L1Structure

문서 → 트리(lift), 트리 → 문서(canonical projection)가 하나씩 정해지며 서로 역함수입니다.

● mindmapmd에서 구현
L2Round-trip

트리 간 구조적 diff·merge, 문서 전체 없이 하위 트리 단위로 다루기.

● 규칙 작성 전

사양 읽기 →

설계 원칙

여전히 마크다운

GitHub, Obsidian 등 지금 쓰는 편집기에서 그대로 열립니다. 도입 비용은 0에서 시작합니다.

의미는 문서에, 표현은 옆에

레이아웃과 스타일은 sidecar에 두고, 모델에 보내는 텍스트에는 넣지 않습니다.

검증 가능한 적합성

확인할 수 없는 사양은 제안일 뿐입니다. 사양과 테스트는 같은 소스에서 생성됩니다.

경쟁보다 상호운용

OPML, JSON Canvas, markmap 등 기존 형식용 어댑터를 먼저 만듭니다.

저장소

spec공개

사양과 규범 예제

mindmapmdL1

참조 구현: lift · canonical projection

conformance예정

테스트 스위트, 러너, 구현 레지스트리

adapters예정

OPML · JSON Canvas · markmap 상호운용

지금이 반대 의견을 내기 가장 좋은 때입니다

사양은 가장 초기이자 가장 바뀌기 쉬운 단계에 있습니다.