Markdown (.md)

Markdown（文件后缀通常为 .md）是由 John Gruber 于 2004 年创建的一种轻量级标记语言。它的核心设计哲学是「纯文本即可读」：即便未经任何编译器渲染，源文件本身的缩进、标点与换行也具有极高的可读性。

在 Maplen 的双轨文档体系中，.md 是所有纯文学叙事、哲学随笔与标准化手记的核心格式。

Maplen 中 .md 的定位与约束

在 Maplen 的内容集合体系中，文档格式有着清晰的职责分工：

• .md（负责纯粹的文字表达）：用于 Notes 随笔、Narrative 纪事或无需复杂交互的 Nodes 实践手记。它不包含任何自定义 JSX 组件标签，交付 100% 干净的语义化 HTML，享有极致的静态输出与文本纯度；
• MDX (.mdx)（负责组件与工程交互）：当手记需要嵌入可交互的物理仿真器、动画或自定义图表时，才升级为 .mdx。

Maplen 对 Markdown 的原生扩展

为了在保持纯文本纯度的同时构建互联的知识花园，Maplen 为 .md 注入了以下增强能力：

1. 双向 Wiki 链接（Wikilinks）：使用 [[词条名|显示别名]] 语法自动解析内部概念网络，并在词条页面反向生成引用索引；
2. 段落级句子锚点：使用 [[anchor:标识符]] 在正文中埋设微观锚点，实现跨手记的精准句级引用；
3. Shiki 代码块工具栏：支持代码块语法高亮、代码行高亮（{4-7}）、代码文件名标头（title="..."）以及一键剪贴板复制；
4. 悬停黑块遮蔽文本（Spoiler）：通过 <span class="spoiler"> 实现剧透与谜底的悬停显示。

完整的排版样式与细节展示，可查阅 文字排版、代码语法与知识网络。

官方网站与标准规范

• 原始定义：John Gruber: Daring Fireball - Markdown 原始规范
• 工业标准：CommonMark 官方标准与交互测试 (commonmark.org)
• 扩展规范：GitHub Flavored Markdown (GFM) 规范指南