# Markdown (.md)

> 轻量级纯文本标记语言与文件格式，Maplen 沉浸式阅读与文字交付的基石

- HTML: /wiki/md/
- Markdown: /wiki/md.md
- Aliases: Markdown, md, .md, 纯文本排版
- Updated: 2026.11.09

---

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

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

## Maplen 中 .md 的定位与约束

在 Maplen 的内容集合体系中，文档格式有着清晰的职责分工：
- **`.md`（负责纯粹的文字表达）**：用于 Notes 随笔、Narrative 纪事或无需复杂交互的 Nodes 实践手记。它不包含任何自定义 JSX 组件标签，交付 100% 干净的语义化 HTML，享有极致的静态输出与文本纯度；
- **[MDX (.mdx)](/wiki/mdx.md)（负责组件与工程交互）**：当手记需要嵌入可交互的物理仿真器、动画或自定义图表时，才升级为 `.mdx`。

## Maplen 对 Markdown 的原生扩展

为了在保持纯文本纯度的同时构建互联的知识花园，Maplen 为 `.md` 注入了以下增强能力：
1. **双向 Wiki 链接（Wikilinks）**：使用 `[显示别名](/wiki/%E8%AF%8D%E6%9D%A1%E5%90%8D.md)` 语法自动解析内部概念网络，并在词条页面反向生成引用索引；
2. **段落级句子锚点**：使用 `[anchor:标识符](/wiki/anchor%3A%E6%A0%87%E8%AF%86%E7%AC%A6.md)` 在正文中埋设微观锚点，实现跨手记的精准句级引用；
3. **Shiki 代码块工具栏**：支持代码块语法高亮、代码行高亮（`{4-7}`）、代码文件名标头（`title="..."`）以及一键剪贴板复制；
4. **悬停黑块遮蔽文本（Spoiler）**：通过 `<span class="spoiler">` 实现剧透与谜底的悬停显示。

完整的排版样式与细节展示，可查阅 [文字排版、代码语法与知识网络](/nodes/markdown-showcase.md)。

## 官方网站与标准规范

- **原始定义**：[John Gruber: Daring Fireball - Markdown 原始规范](https://daringfireball.net/projects/markdown/)
- **工业标准**：[CommonMark 官方标准与交互测试 (commonmark.org)](https://commonmark.org/)
- **扩展规范**：[GitHub Flavored Markdown (GFM) 规范指南](https://github.github.com/gfm/)