leafer
发布于 2025-12-13 / 2 阅读
0
0

Markdown 常用语法规则

Markdown 是一种轻量级标记语言,通过简单符号实现文本格式化。相对于 LaTeX 这类专业的排版语言,Markdown 更简单易用,适用于笔记,博客等场景。Markdown 语法规则较为简单,但不同的 Markdown 解析器对语法的支持可能有所不同,本文仅对基础语法进行简单的介绍,

标题

使用#表示,数量对应级别。

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

文本样式

  • 加粗:**加粗文本** 或 __加粗文本__ → 加粗文本

  • 斜体:*斜体文本* 或 _斜体文本_ → 斜体文本

  • 粗斜体:***粗斜体文本*** 或 ___粗斜体文本___ → 粗斜体文本

  • 删除线:~~删除线文本~~ →删除线文本

  • 转义字符:使用\输出特殊符号,例如:\* 这不是斜体 \* → 这不是斜体

  • 引用:使用 > 表示:> 引用文本 →

引用文本

  • 分割线:三个或更多 * 、 - 或 _,例如 ***---___ →

列表

无序列表

使用 -* 或 +,示例:

- 项目1
- 项目2
  - 子项目

有序列表

使用数字加点,示例:

1. 第一项
2. 第二项
  1. 子项

任务列表

使用- [x] 和 - [ ],示例:

- [x] 已完成任务
- [ ] 待办任务

图片

图片的格式可表示为![显示文本](图片地址或链接),显示文本在图片无法加载时显示。可以使用本地图片地址,也可使用图床生成链接。

表格

使用 | 和 - 创建,使用 : 改变对齐方式,示例:

默认对齐

左对齐

居中对齐

右对齐

单元格内容

单元格内容

单元格内容

单元格内容

| 默认对齐 | 左对齐 | 居中对齐 | 右对齐 |
| --- | :--- | :---: | ---: |
| 单元格内容 | 单元格内容 | 单元格内容 | 单元格内容 |

代码

  • 行内代码: inline code  → inline code

  • 代码块:三个反引号包裹,可指定语言,若需要在代码块内输入三个反引号,则代码块的界定符需比内部使用更多的反引号:

```python
print("Hello, Markdown!")
```

数学公式

支持 LaTeX 语法,需依赖 MathJax 或 KaTeX 渲染。

  • 行内公式:$y = x^2$ → y = x2

  • 行间公式:$$e^{i\theta} = \cos(\theta) + i\sin(\theta)$$ → e = cos(θ) + i sin(θ)

  • 在行间公式嵌入 LaTeX 公式环境,示例:

$$
\begin{equation}
  |x| = 
    \begin{cases}
      x & \text{if } x \geq 0 \\
      -x & \text{if } x < 0
    \end{cases}
\end{equation}
$$
  • 使用 \tag{} 命令为公式手动指定一个编号或标记,用于公式的引用和说明,\tag*{} 命令可以去除包围标签的圆括号,在引用公式时,标签需手动输入,示例:

$$
\begin{equation}
    \begin{split}
        e^x &= \sum_{n=0}^{\infty} \frac{x^n}{n!}  \\
        &= 1 + x + \frac{x^2}{2!} + \frac{x^3}{3!} + \cdots + \frac{x^n}{n!} + \cdots
    \end{split}
\end{equation}
\tag*{1-1}
$$

链接

行内链接

行内链接直接在行内定义链接的文本和地址。其格式可表示为[显示文本](链接地址 "可选标题")显示文本 是页面上显示的文字,链接地址 是链接的实际地址,"可选标题"是鼠标悬停在链接上时出现的提示文字,可以省略。

示例:
[Leafer](https://leafer.cn/ "Leafer") → Leafer[1]

参考链接

当同一个链接在文章中出现多次时,使用这种方法可以方便统一管理。语法分为两部分:

  • 链接位置:在文中需要链接的地方写 [链接文字][链接标识]

  • 链接定义:在文档的任意位置(通常放在末尾)写 [链接标识]: 真实的链接地址

示例:

打开[Leafer][1],可阅读博文。

[1]:https://leafer.cn/

自动链接

用尖括号 < > 包裹网址或邮箱地址,Markdown 会自动将其转换为可点击的链接。

脚注链接

脚注链接用于在文章底部添加解释或引用来源。语法分为两部分:

  • 添加注脚标记:在需要注释的文字后面加上 [^注脚标识]

  • 定义注脚内容:在文档末尾(或其他位置)写 [^注脚标识]: 注脚的解释内容

示例:

使用 Markdown[1]可以高效地写作,利用 Leafer[2]可阅读博文。

1.HyperText Markup Language 超文本标记语言↩︎
2.Leafer: https://leafer.cn/↩︎

使用 Markdown[^1] 可以高效地写作,利用 Leafer[^2]可分享自己的文章。

[^1]:HyperText Markup Language 超文本标记语言
[^2]:Leafer: https://leafer.cn/

锚点链接

锚点链接用于在当前文档内部进行跳转,通常需要为标题定义一个标识符,然后用普通链接语法指向它。语法分两个部分:

  • 定义锚点:在标题后加上 {#自定义锚点名称},例如:## 章节标题 {#section1}

  • 链接到锚点:[跳转到某一章](#section1)

复杂样式

Markdown 本身不支持复杂样式,但可通过嵌入 HTML 标签并结合 CSS 样式实现个性化排版,核心是利用 HTML 的 style 属性或 <style> 标签定义样式。

Markdown 已实现的文本样式:

  • 加粗文本:<strong> / <b>

  • 倾斜文本:<em> / <i>

  • 删除线:<del>

  • 分割线:<hr>

  • 行内代码:<code>

  • 代码块:<pre>

  • 行内引用:<q>

  • 引用块:<blockquote>

使用 HTML 标签可实现 Markdown 无法实现的文本样式,例如:

  • 上标:<sup>上标</sup>X<sup>2</sup> → X2

  • 下标:<sub>下标</sub>Y<sub>2</sub> → Y2

  • 下划线:<u>下划线</u> 或 <ins>下划线</ins> → 下划线

  • 高亮文本:<mark>高亮文本</mark> →高亮文本

使用 <div> 标签下的 align 属性可以设置文本对齐方式,文本对齐示例:

这段文本居左显示

这段文本居中显示

这段文本居右显示

<div align="left">这段文本居左显示</div>
<div align="center">这段文本居中显示</div>
<div align="right">这段文本居右显示</div>

使用 <font> 标签下的 color 属性可以设置文本颜色,face 属性可以设置文本字体,size 属性可以设置文本字号,文本颜色示例:
这是红色文字
这是黄色文字
这是绿色文字
这是蓝色文字

<font color="red">这是红色文字</font>
<font color="yellow">这是黄色文字</font>
<font color="#00FF00">这是绿色文字</font>
<font color="#0000FF">这是蓝色文字</font>


评论