Markdown
文档标记与写作规范
- 001入门Markdown 语法指南Markdown 入口篇:从给项目写 README 的真实任务出发,五分钟建立正反馈,理解空白即语法的设计哲学,并给出全模块三层学习路径。
- 002入门Markdown 标题语法ATX 与 Setext 两种标题写法、空格与闭合序列等解析规则、层级规划与目录生成。
- 003入门Markdown 段落与换行段落与换行:空行分段、三种硬换行写法、软换行的平台差异与行尾空白陷阱。
- 004入门Markdown 基础文本格式强调语法精讲:斜体/粗体的星号与下划线差异、词内强调规则、删除线与上标下标等扩展格式。
- 005中级Markdown 链接与图片行内链接、引用链接、自动链接、图片嵌入、替代文本必填与图片套链接的嵌套写法。
- 006入门Markdown 列表语法无序/有序/任务列表语法、嵌套缩进规则、起始序号控制与列表内嵌块级元素的细节。
- 007入门Markdown 引用块引用块的基础写法、懒延续规则、嵌套引用与引用内嵌其他块级元素的组合。
- 008入门转义字符Markdown 转义机制:反斜杠的可转义字符集、行尾硬换行、HTML 实体与表格管道符等常见陷阱。
- 009中级Markdown 代码块与语法高亮行内代码、围栏代码块、语言标注与高亮配置。
- 010中级Markdown 表格GFM 表格语法:分隔行的设计原因、对齐约定与数字右对齐、单元格边界规则、表格与列表的选型决策、遮代码自检与 HTML 兜底。
- 011中级GitHub Flavored MarkdownGFM 扩展全览:表格、任务列表、删除线、自动链接、脚注、警报块与 GitHub 平台特有行为。
- 012入门删除线GFM 删除线语法:规则细节、与 HTML 标签的语义分工、跨平台兼容与工程用法。
- 013入门自动链接自动链接:尖括号语法(CommonMark)与裸 URL 识别(GFM 扩展)的规则、边界与差异。
- 014入门Emoji 表情Markdown 中使用 Emoji 的两种方式:GitHub 短代码与 Unicode 字符,及其平台兼容性。
- 015中级脚注Markdown 脚注语法:标记与定义的配对模型、为什么需要脚注、定义位置无关渲染顺序、多平台兼容性与遮代码自检实践。
- 016中级下标与上标Markdown 中实现上下标的三种方式:HTML 标签、LaTeX 公式与平台扩展语法,及选型建议。
- 017入门Markdown 任务列表GFM 任务列表语法:复选框的识别规则、GitHub 交互行为、嵌套与实战场景。
- 018入门Markdown 提示框(admonition/callout)GitHub 警报块、Obsidian Callout、MkDocs 与 Docusaurus 提示框语法及跨平台兼容方案。
- 019中级锚点跳转锚点机制:GitHub 标题 slug 规则、自定义锚点、页内与跨文档跳转的写法与排错。
- 020入门自动目录自动目录(TOC)的实现方式:各平台占位符语法、GitHub 手动锚点目录、生成工具与维护建议。
- 021中级LaTeX 数学公式Markdown中LaTeX数学公式的完整语法:行内公式、块级公式与KaTeX兼容性。
- 022中级Mermaid 图表Mermaid图表语法:流程图、时序图、甘特图、类图与状态图的完整用法。
- 023中级Markdown HTML 内嵌内嵌 HTML 的机制与边界:块级行内规则、GitHub 消毒白名单、details 折叠与实用标签,及安全注意事项。
- 024中级CommonMark 规范CommonMark规范详解:标准化Markdown的定义、解析规则与一致性测试。
- 025中级Markdown 定义列表定义列表的扩展语法(PHP Markdown Extra 等)、各渲染器支持差异与 CommonMark 兼容替代方案。
- 026中级Markdown Frontmatter YAMLMarkdown 文件头部的 YAML frontmatter:两套读者的心智模型、标量/数组/对象字段、类型陷阱、托管字段与工具链协作、遮代码自检实践。
- 027中级规范文档编写编写规范技术文档的组合技巧:表格进阶、脚注、目录、交叉引用与文档结构约定。
- 028入门编辑器功能Markdown编辑器核心功能:实时预览、快捷键操作与高效编辑技巧。
- 029中级转换工具Markdown转换工具:Pandoc的安装、使用与高级转换技巧。
- 030中级格式化与检查工具Markdown 工程化工具链:markdownlint 结构检查、Prettier 统一格式、MDX 组件化写作与 CI 集成。
- 031入门文档站点与自动化工具链把 Markdown 变成文档站点的完整工具链:静态站点生成器、构建管线、代码生成文档与质量门禁
- 032中级图片 CDN 加速Markdown图片CDN加速方案:图床选择、CDN配置、懒加载与性能优化。
- 033中级版本控制下的 PR 协作Markdown在版本控制PR协作中的应用:模板、评论、审查与文档维护。
- 034入门用 Markdown 做演示文稿Marp、Slidev 与 reveal.js 三条路线的分页语法、讲者注释、主题与导出对比
- 035入门个人知识库与双链笔记Obsidian wikilink 与 backlinks、frontmatter 属性组织、vault 的 Git 备份——Markdown 的知识库形态