陌阡博客

主题

第 1 章：初识 Markdown ​

Markdown 不是一门编程语言，而是一种「让写作回归写作本身」的轻量级标记语言。

学习目标 ​

  • 理解什么是 Markdown 以及它解决什么问题
  • 了解 Markdown 的发展历史与设计哲学
  • 认识 Markdown 的主流应用场景
  • 建立对后续学习的整体预期

1.1 什么是 Markdown ​

Markdown 是一种轻量级标记语言（Lightweight Markup Language），由 John Gruber 和 Aaron Swartz 于 2004 年共同创建。它的核心设计理念是：用简洁的纯文本符号，表达丰富的文档格式。

一句话概括：用易读易写的纯文本，写出结构清晰、格式丰富的文档。

举个最直观的例子，左边是 Markdown 源码，右边是渲染效果：

源码：

markdown
# 今天的工作计划

- [x] 完成需求文档
- [ ] 参加下午评审会
- [ ] 修复登录页面的 Bug

**截止时间：** 本周五 18:00

渲染效果：

今天的工作计划 ​

  • [x] 完成需求文档
  • [ ] 参加下午评审会
  • [ ] 修复登录页面的 Bug

截止时间： 本周五 18:00

可以看到，Markdown 源码本身就是易读的纯文本，即使没有渲染器也能直接理解内容。而经过渲染后，它又能呈现出漂亮的结构化格式。

1.2 Markdown 解决了什么问题 ​

在 Markdown 诞生之前，如果你想写一份带格式的文档，通常只有两条路：

方式优点痛点
Word / WPS功能强大、所见即所得二进制格式不可读、版本控制困难、不同版本兼容性差
HTML纯文本、可版本控制标签冗长繁琐，写作效率低，可读性差

Markdown 在两者之间找到了一个完美的平衡点：

纯文本（可读可写） + 简单符号（表达格式） = Markdown

Markdown 定位图

它真正改变了技术文档的写作方式——程序员可以用它写 README、API 文档、技术博客；作家可以用它专注于内容本身而非排版细节。

1.3 发展简史 ​

2004 ─── Markdown 1.0 诞生，由 Gruber 与 Swartz 发布
  │
2006 ─── GitHub 成立（2008），率先在代码仓库中支持 Markdown
  │
2012 ─── 社区推动标准化努力，催生 CommonMark 项目
  │
2014 ─── CommonMark 规范发布，标准化核心语法
  │
2017 ─── GitHub Flavored Markdown (GFM) 正式规范发布
  │        新增：表格、任务列表、删除线、语法高亮等
  │
2020+ ─  Mermaid、LaTeX 数学公式等扩展广泛支持
  │        Obsidian、Notion、飞书等工具推动 Markdown 破圈
  │
现在 ─── Markdown 已成为技术写作的事实标准

关键节点：

  • CommonMark：标准化核心语法，解决了不同平台解析差异的问题
  • GitHub Flavored Markdown (GFM)：GitHub 的扩展版本，增加了表格、任务列表等实用语法，是目前最广泛使用的「方言」
  • 现代编辑器：Typora、Obsidian、VS Code 等让 Markdown 写作体验接近「所见即所得」

1.4 语法方言说明 ​

需要了解的是，原版 Markdown 的功能非常有限（只有标题、段落、列表、链接、图片、代码等基础语法）。后来各平台在原版基础上做了大量扩展，形成不同的「方言」。

本书教授的语法基于 GitHub Flavored Markdown (GFM)，这是目前应用最广泛的方言，同时也是绝大多数平台的通用子集。在个别语法上，我们会标注出兼容性差异。

语法特性原版 MarkdownGFM本书覆盖
标题/段落/粗体/斜体✅✅第 2 章
列表/嵌套列表✅✅第 3 章
链接/图片✅✅第 4 章
引用块/分隔线✅✅第 5 章
行内代码/代码块✅✅第 6 章
表格❌✅第 7 章
任务列表❌✅第 3 章
删除线❌✅第 2 章
表情符号❌✅第 10 章
高亮❌✅第 2 章
Mermaid 图表❌✅第 10 章
数学公式❌✅第 10 章

1.5 主流应用场景 ​

Markdown 已经渗透到技术写作的方方面面：

代码仓库 ​

GitHub、GitLab、Gitee 的 README、Issue、Pull Request 描述全部使用 Markdown。一个优秀的 README 是开源项目的门面。

技术博客 ​

Hexo、Hugo、Jekyll、VuePress 等静态博客框架均以 Markdown 为核心写作格式。很多技术写作者甚至会先写完 Markdown，再一键生成博客。

项目文档 ​

越来越多的项目使用 Markdown 编写文档（如 Vue.js、React 官方文档），配合 VitePress、Docusaurus 等工具生成精美的文档网站。

即时通讯 ​

Slack、Discord、飞书、钉钉等工具在消息中支持部分 Markdown 语法，让聊天消息也能有结构感。

个人笔记 ​

Obsidian、Notion、Logseq、思源笔记等新一代笔记工具以 Markdown 为基础格式，支持双向链接、知识图谱等高级功能。

Markdown 应用场景全景图

1.6 本书的结构 ​

本书分为五个部分，由浅入深：

部分章节范围定位
入门篇第 1-2 章了解概念、掌握基础语法
核心篇第 3-6 章掌握日常写作的必备语法
进阶篇第 7-9 章表格、转义、脚注等进阶技巧
高级篇第 10-11 章数学公式、Mermaid 图表、HTML 混排
实践篇第 12-14 章工具、场景、最佳实践

每章末尾都有小结和下一章预告，帮助建立知识关联。

本章小结 ​

要点说明
Markdown 是什么轻量级标记语言，用纯文本表达丰富格式
核心优势纯文本可读、语法简洁、跨平台兼容、版本控制友好
标准演进原版 → CommonMark 标准 → GFM 扩展
本书基准基于 GFM（GitHub Flavored Markdown）
应用场景GitHub、博客、文档、笔记、即时通讯

下一章预告 ​

下一章我们将真正动笔写 Markdown，从最基础的标题、段落和文本格式开始。准备好了吗？

📖本文阅读--次|📊全站访问--次|👥访客--人