Markdown 语法指南

Markdown 语法指南

目录

• Markdown 语法指南
  • 目录
  • 简介
  • 基本语法
    • 标题
    • 段落
    • 换行
    • 强调
    • 引用
    • 列表
    • 代码
    • 分隔线
    • 链接
    • 图片
    • 转义字符
  • 扩展语法
    • 表格
    • 任务列表
    • 数学公式
    • Mermaid 图表
  • HTML 与 Markdown 混用
  • 最佳实践

简介

Markdown 是一种轻量级标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档，可与 HTML 混编，可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写，Markdown 被大量使用，如 GitHub、Wikipedia、简书等。

Markdown 的语法十分简单，常用的标记符号不超过十个，用于日常写作记录绰绰有余，不到半小时就能完全掌握。就是这十个不到的标记符号，却能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。

基本语法

标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落

段落的前后要有空行，所谓的空行是指没有文字内容的行。若想在段落内换行，可以在上一行末尾插入两个以上的空格然后回车。

这是第一段文字。

这是第二段文字。

换行

在行末插入两个或多个空格，然后按回车键，即可创建一个换行。

这是第一行  
这是第二行

强调

Markdown 使用星号（*）和下划线（_）作为强调标记。

粗体：使用两个 * 或 _ 包围文本

**粗体文本**
__粗体文本__

斜体：使用一个 * 或 _ 包围文本

*斜体文本*
_斜体文本_

粗斜体：使用三个 * 或 _ 包围文本

***粗斜体文本***
___粗斜体文本___

引用

在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

> 这是一段引用文本

引用可以嵌套：

> 这是第一级引用
>> 这是第二级引用
>>> 这是第三级引用

列表

无序列表：使用 -、* 或 + 作为列表标记