Markdown on PlumePHP

Markdown 与文档工程：写作规范、静态生成与 LaTeX 排版

Wed, 30 Sep 2026 14:00:00 +0800

引言

文档是软件系统中寿命最长的代码——功能会重构，接口会迭代，但文档是第一份和最后一份与你同行的资产。Markdown 成了事实标准：它足够轻让你专注写作，又足够丰富经工具链渲染为出版级产出。本文从 Markdown 核心语法与方言出发，延伸到写作规范、协作流、静态生成工具（Docusaurus/VitePress/MkDocs/Hugo）、LaTeX 公式排版与多格式输出，给把「写文档」从「负担」变成「杠杆」的起点。

富文本编辑与内容渲染管线：Markdown、提及标签与安全渲染

Mon, 28 Sep 2026 12:00:00 +0800

发一条内容，看着是「打字 + 展示」，背后是一条内容管线：编辑器把用户输入变成结构化数据，服务端把数据渲染成安全可展示的 HTML，客户端再嵌入媒体、懒加载、渲染。这条管线最容易出问题的地方有两个：一致性（编辑预览不一致）和 安全性（XSS 注入）。本文把内容管线拆开讲：编辑器选型、内容数据模型、提及与标签解析、安全渲染、媒体嵌入与性能。