Markdown 终极语法指南 (The Ultimate Markdown Cheatsheet)

欢迎来到我的个人知识库!这是一个全面的 Markdown 语法参考。它涵盖了从基础到高级的各种语法,特别包含了 GitHub Flavored Markdown (GFM) 的常用功能以及 LaTeX 数学公式的用法。


目录 (Table of Contents)


1. 标题 (Headings)

使用 # 号来创建标题,# 的数量代表标题的级别。

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

2. 文本格式化 (Text Formatting)

样式语法示例
粗体**文字**__文字__Hello, World!
斜体*文字*_文字_Hello, World!
粗斜体***文字***___文字___Hello, World!
删除线~~文字~~Goodbye, World!

如下:

| 样式 | 语法 | 示例 |
| :--- | :--- | :--- |
| **粗体** | `**文字**` 或 `__文字__` | **Hello, World!** |
| *斜体* | `*文字*` 或 `_文字_` | *Hello, World!* |
| ***粗斜体*** | `***文字***` 或 `___文字___` | ***Hello, World!*** |
| ~~删除线~~ | `~~文字~~` | ~~Goodbye, World!~~ |

3. 段落与换行 (Paragraphs & Line Breaks)

  • 新段落: 在两段文字之间留一个空行。

  • 强制换行: 在一行的末尾输入两个或更多的空格,然后按回车。
    这行文字的末尾有两个空格,所以会强制换行。


4. 引用 (Blockquotes)

使用 > 符号来创建引用块。可以进行嵌套。

这是一个引用。

这是一个嵌套的引用。

嵌套可以有很多层。


5. 列表 (Lists)

无序列表 (Unordered Lists)

使用 *, +, 或 - 来创建无序列表。(他们是等价的)

  • 列表项 A
    • 嵌套列表项 A1
    • 嵌套列表项 A2
  • 列表项 B
  • 列表项 C

有序列表 (Ordered Lists)

使用数字加点 . 来创建有序列表。

  1. 第一步
  2. 第二步
    1. 步骤 2.1
    2. 步骤 2.2
  3. 第三步

6. 代码 (Code)

行内代码 (Inline Code)

使用反引号 ` 来包裹代码。例如, console.log('Hello'); 是一个行内代码。

代码块 (Fenced Code Blocks)

使用三个反引号 ``` 来创建代码块,并可以在后面指定语言以获得语法高亮。

# 这是一个 Python 代码块
def factorial(n):
    if n == 0:
        return 1
    else:
        return n * factorial(n-1)

print(factorial(5))
// 这是一个 JavaScript 代码块
const greet = (name) => {
  console.log(`Hello, ${name}!`);
};

greet('GitHub');
  • 基本链接: [链接文字](URL) 访问谷歌

  • 带标题的链接: [链接文字](URL "悬停时显示的文字") GitHub官网


8. 图片 (Images)

语法与链接类似,只是在前面加一个感叹号 !

![文字](图片URL)

HCHO


9. 水平分割线 (Horizontal Rules)

在一行中使用三个或更多的 *, -, 或 _ 来创建分割线。





10. 表格 (Tables)

使用管道符 | 和连字符 - 来创建表格。使用冒号 : 控制对齐方式。

左对齐居中对齐右对齐
苹果香蕉橙子
笔记本显示器鼠标
MarkdownLaTeXGit

11. 任务列表 (Task Lists)

在列表项前加上 [ ][x] 来创建任务列表。

  • 完成 Markdown 语法学习
  • 将笔记上传到 GitHub
  • 学习 Git 的更多高级用法

12. LaTeX 数学公式 (Mathematical Formulas)

这是在技术笔记中非常有用的功能。GitHub 的 Markdown 渲染器支持 MathJax。

行内公式 (Inline Formulas)

使用一对美元符号 $ 包裹 LaTeX 代码。

示例: 爱因斯坦的质能方程是。一个简单的二次方程是

块级公式 (Block Formulas)

使用两对美元符号 $$ 包裹 LaTeX 代码,公式会居中并单独成行。

示例: 著名的欧拉恒等式:

高斯积分:

常用 LaTeX 语法:

描述语法渲染效果
分数\frac{a}{b}
求和\sum_{i=1}^{n}
积分\int_{a}^{b}
极限\lim_{x \to \infty}
希腊字母\alpha, \beta, \gamma
上标/下标x^2, y_{10},

更多LaTex语法:

含义 (Meaning)LaTeX 命令 (Command)显示效果 (Rendered)
逻辑连词 (Logical Connectives)
与 (and)\land\wedge
或 (or)\lor\vee
非 (not)\neg
蕴含 (implies)\rightarrow
逻辑蕴含 (logical implication)\Rightarrow
当且仅当 (if and only if, iff)\leftrightarrow
逻辑等价 (logical equivalence)\Leftrightarrow
否定\neg
量词 (Quantifiers)
对所有 (for all)\forall
存在 (there exists)\exists
集合论 (Set Theory)
属于 (element of)\in
不属于 (not an element of)\notin
子集 (subset of)\subset
子集或等于 (subset or equal to)\subseteq
父集 (superset of)\supset
父集或等于 (superset or equal to)\supseteq
并集 (union)\cup
交集 (intersection)\cap
空集 (empty set)\emptyset
证明与推论 (Proof and Inference)
所以 (therefore)\therefore
因为 (because)\because
Tautology (顶)\top
Contradiction (底)\bot
断言/推导出 (turnstile)\vdash

希腊字母 (Greek Letters)

注意: 大写希腊字母的命令通常是首字母大写,例如 \gamma (小写 ) 和 \Gamma (大写 )。

小写字母LaTeX 命令大写字母LaTeX 命令
\alphaA (就是A)
\betaB (就是B)
\gamma\Gamma
\delta\Delta
\epsilonE (就是E)
\zetaZ (就是Z)
\etaH (就是H)
\theta\Theta
\iotaI (就是I)
\kappaK (就是K)
\lambda\Lambda
\muM (就是M)
\nuN (就是N)
\xi\Xi
oO (就是o)
\pi\Pi
\rhoP (就是P)
\sigma\Sigma
\tauT (就是T)
\upsilon\Upsilon
\phi\Phi
\chiX (就是X)
\psi\Psi
\omega\Omega

特殊的变体字母:

变体LaTeX 命令
\varepsilon
\vartheta
\varpi
\varrho
\varsigma
\varphi

基本运算符 (Basic Operators)

含义LaTeX 命令渲染效果
加号+
减号-
乘号 (点)\cdot
乘号 (叉)\times
除号 (分数线)\frac{a}{b}
除号 (横线)\div
正负号\pm
负正号\mp
等于号=
不等于\ne\neq
约等于\approx
大于>
小于<
大于等于\ge\geq
小于等于\le\leq

13. 高级技巧 (Advanced Tips)

转义字符 (Escaping Characters)

如果你想显示 Markdown 中的特殊字符(如 *#),可以在它们前面加上反斜杠 \

我想显示一个星号 *,而不是让它变成斜体。

嵌入 HTML

Markdown 支持直接写入 HTML 代码,这给了你更大的灵活性。

示例: 使用 <u> 标签实现下划线效果

使用 <details><summary> 创建一个可折叠的内容区域。

点击这里展开/折叠 这里是可以被隐藏和显示的内容捏^-^。

14. 彩色提示框 (Admonitions)

这是我们新安装的 mdbook-admonish 插件的效果展示。它可以生成醒目的彩色区块,非常适合用来写提示、警告或补充说明。

基础用法

语法代码


```admonish note "这是标题"
这里写提示框的内容。支持 **Markdown** 语法。
```

渲染效果

这是标题

这里写提示框的内容。支持 Markdown 语法。


更多类型展示

1. 警告 (Warning)

注意安全

这是一条警告信息!请务必小心操作。

2. 成功 (Success)

Success

恭喜! 你的插件配置完美运行。如果不写标题,默认为 "Success"。

3. 小贴士 (Tip)

小技巧

这是一个有用的小知识点。

4. 错误/失败 (Failure)

运行错误

哎呀,程序崩溃了。

5. 折叠样式 (Collapsible)

如果不希望内容占用太多空间,可以设置为默认折叠:

Example

def hello():
    print("Hello Admonish!")