# Markdown (.md)

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

- Site: https://maplen.top/
- Page: https://maplen.top/wiki/md/
- LLM: https://maplen.top/wiki/md/llms.txt
- Author: 红枫 (Maple)
- Audience: AI agents / LLM tools
- Updated: 2026.11.09
- Markdown: https://maplen.top/wiki/md.md

## Content

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/)

## Backlinks

- [从源码到边缘：基于 GitHub 与 Cloudflare Workers 的全自动持续交付](https://maplen.top/nodes/deployment-showcase/llms.txt): 摒弃沉重的动态服务器与数据库，解析 Maplen 的静态技术路线选型、Git 源码资产沉淀，以及基于 Cloudflare Workers 静态资产网络的全自动持续交付流水线
- [纸、墨与四色：我为什么这样设计 Maplen](https://maplen.top/nodes/design-system/llms.txt): 从一张纸、四种语气到统一模板与局部嵌入，这是我为 Maplen 确立的建站理念、核心架构与设计手记
- [双轨交付：面向人类的暖纸与面向 AI 的 llms.txt](https://maplen.top/nodes/llms-and-feeds-showcase/llms.txt): 解析全站 /llms.txt 知识索引、原生纯文本 Markdown 镜像与多级 RSS 订阅流的双轨分发哲学
- [笔墨与纸面：Maplen 的排版美学与文本地基](https://maplen.top/nodes/markdown-showcase/llms.txt): 从字形微调、行间呼吸到 Wiki 双向链接与微观句子锚点，为长篇沉浸阅读筑牢坚实的地基
- [架构图与系统流向：Maplen 是如何运转的](https://maplen.top/nodes/architecture-showcase/llms.txt): 从 4N 正交体系到静态优先流水线，用 Mermaid 图表全景解析我为 Maplen 搭建的底层逻辑
- [Astro](https://maplen.top/wiki/astro/llms.txt): 现代静态优先、内容驱动的 Web 框架，Maplen 的基座构建引擎与孤岛架构运行时
- [MDX (.mdx)](https://maplen.top/wiki/mdx/llms.txt): 在 Markdown 中无缝嵌入 JSX 组件的超集格式，Maplen 实现可交互工程手记的媒介
- [Mermaid](https://maplen.top/wiki/mermaid/llms.txt): 基于文本的声明式图表绘制语法，Maplen 架构拓扑与状态机可视化的内嵌引擎