如何让 Markdown 文档具备更好的可移植性与可维护性？

1. 优先使用标准语法

尽量采用 CommonMark 规范中的通用语法，避免依赖单一平台私有的非标准扩展，减少迁移成本

2. 用 front matter 管理元数据

通过 YAML front matter 等约定在文件头部声明标题、作者、日期等元信息，而非将其混入正文

3. 统一文件约定

使用 .md 或 .markdown 扩展名，并在团队内约定一致的命名规则与目录结构

4. 慎用裸 HTML

仅在必要时嵌入原始 HTML，以降低在不同解析器之间的兼容风险