原文：Markdown基础语法介绍 | Colin Gretzky的博客
本文介绍 Markdown 笔记格式的基础功能，涵盖核心语法和使用要点，适合初学者快速上手。
Markdown 简介
Markdown 是一种轻量级的标记语言，由 John Gruber 于 2004 年设计。它的核心理念是：让写作者专注于内容本身，而非排版样式——用简单的符号标记格式，源码可读，渲染美观。
优势
| 特性 | 说明 |
|---|---|
| 沉浸写作 | 纯键盘操作，无需鼠标切换工具栏，写作流不中断 |
| 高兼容性 | 支持所有主流平台（GitHub、Obsidian、Notion、飞书等），内容迁移零成本 |
| 结构清晰 | 标题层级、列表、引用一目了然，即使纯文本状态下也保持可读性 |
| 低学习成本 | 核心语法只需几分钟即可掌握 |
| 公式能力强 | 基于 LaTeX 语法，可渲染从简单到复杂的各类数学公式 |
| 生态完善 | 大量编辑器、插件、主题、转换工具支持 |
局限性
- 样式统一但不够灵活：Markdown 的设计目标是"足够好用"而非"无所不能"。复杂的排版（如多栏布局、精确控制间距）需要借助 HTML 或 CSS 补充
- 输出格式依赖渲染器：同一份 Markdown 在不同平台上的渲染效果可能存在细微差异
- 可能被误认为 AI 生成：现在许多 AI 输出默认使用 Markdown 格式，尤其带 emoji 的 Markdown 文本在非 Markdown 环境中粘贴时显得突兀，容易让人误以为是 AI 直接复制的结果
块的概念
Markdown 引入了块（Block）的概念——这是它区别于传统文本编辑器的核心设计之一。
什么是块
在 Markdown 中，内容以"块"为单位组织。每两个块之间用空行隔开，每个块可以独立设定自己的类型：标题、段落、列表、引用、代码块、公式块等。
┌─────────────────────┐ │ 这是一个段落块 │ ← 段落块 │ 换行继续写仍是同一块 │ └─────────────────────┘ ← 空行（块的分隔线） ┌─────────────────────┐ │ 这是另一个段落块 │ ← 新的段落块 └─────────────────────┘在 Obsidian 这类"块编辑器"中，按回车会关闭当前块并创建一个新的块，新块可以切换为不同的类型。
块的特性
①块是原子单位
一个块是一个不可分割的整体。块内的所有文本共享同一套格式设定——你不能让块内的前半部分是标题、后半部分是普通文本。每当你切换块类型，改动会作用于块内全部内容。
正确理解：
# 这一整行都是标题1 这里是普通段落 |← 整个块 →|做不到的事情：
# 这部分是标题 ← 无法实现：同一块内混合不同格式 这部分又是普通文本② 换行规则
在一个块内部，直接按回车（单个换行）会产生新段落，不是文本内部的软换行。要在块的内部换行需要Shift + Enter（回车）
这是第一行（同一块内） 这是第二行，仍然属于同一个块 这是新的段落块（中间有空行）这个规则的好处是：即使 Markdown 源码没有自动换行，渲染后的阅读体验仍然清晰
③ 块类型的多样性
Markdown 常见的块类型包括：
| 块类型 | 语法标记 | 用途 |
|---|---|---|
| 段落 | 无特殊标记 | 普通文本 |
| 标题 | #~###### | 层级标题 |
| 引用 | > | 引用内容 |
| 无序列表 | -/* | 列表项 |
| 有序列表 | 1. | 编号列表 |
| 代码块 | ``` | 代码片段 |
| 公式块 | $$ | 数学公式 |
层级与结构编辑
所有 Markdown 符号都应在英文输入法下输入（半角符号），否则可能因字符编码不匹配导致格式无效。
标题
用#加空格表示标题层级。#的个数对应标题的级别：
# 标题1（文章大标题） ## 标题2（章节标题） ### 标题3（子章节） ###### 标题6（最小标题，大小接近加粗正文）注意区分标签与标题：#与文字之间有空格= 标题#与文字之间无空格= 标签（Tag），用于分类和检索
# 这是一个标题 #这是一个标签引用
在文本的最左侧输入>将该段设为引用样式：
> 此处输入要引用的文本引用块内部，文本样式（加粗、斜体等）仍然有效，但大部分块级格式（标题、列表）会失效：
此处为引用效果
标题功能失效
加粗和斜体仍然有效
列表
无序列表：用-、*或+加空格开头
- 项目一 - 项目二 - 子项目（缩进两个空格）有序列表：用1.、2.加空格开头
1. 第一步 2. 第二步 1. 子步骤（缩进两个空格）代码块
用三个反引号包裹代码片段，可在开头指定语言以启用语法高亮：
```python print("Hello, World!") ```公式块
用两个美元符号$$包裹 LaTeX 公式：
$$ E = mc^2 $$注意：必须使用美元符号$，而非人民币符号¥，否则无法识别。
文本样式
文本样式作用于块内的部分文字，与块级格式不同，它们可以混合使用。
快速参考
| 样式 | 语法 | 快捷键（Win / Mac） | 效果 |
|---|---|---|---|
| 加粗 | **文字** | Ctrl+B / Cmd+B | 加粗效果 |
| 斜体 | *文字* | Ctrl+I / Cmd+I | 斜体效果 |
| 删除线 | ~~文字~~ | 无默认快捷键 | 删除线效果 |
| 高亮 | ==文字== | 无默认快捷键 | 高亮效果 |
代码 | `文字` | 无默认快捷键 | 行内代码样式 |
| 链接 | [文字](url) | Ctrl+K / Cmd+K | 链接效果 |
| 图片 |  | 无默认快捷键 | 显示图片 |
详细说明
加粗与斜体是最常用的文本样式，支持嵌套使用：
**加粗文本** *斜体文本* ***加粗加斜体***删除线用两个波浪号包裹。注意区分中文全角～和英文半角~——只有后者有效：
~~这句被删掉了~~高亮用两个等号包裹，在 Obsidian 等支持该语法的编辑器中呈现荧光笔效果：
==这是高亮文字==行内代码用单个反引号包裹，适合在段落中标记函数名、文件名或短代码片段：
使用 `git commit` 命令提交更改。链接的格式为[显示文字](目标地址)，支持网页链接和笔记内部链接：
[GitHub](https://github.com) [本地笔记](我的笔记.md)图片的格式为，替代文字在图片加载失败时显示：
公式（行内）
如果需要在一段文字中嵌入公式（而非独立公式块），使用单个美元符号包裹：
爱因斯坦的质能公式 $E = mc^2$ 是物理学中最著名的方程之一。效果：爱因斯坦的质能公式 E = mc^2 是物理学中最著名的方程之一。
分割线
如果需要在文章输入分割线，则要输入---
效果:
总结：Markdown 语法速查
───────────────────────────────────────────── 类型 语法 ───────────────────────────────────────────── 标题 # H1 → ###### H6 加粗 **文字** 斜体 *文字* 删除线 ~~文字~~ 高亮 ==文字== 行内代码 `代码` 链接 [文字](url) 图片  引用 > 文字 无序列表 - 项目 有序列表 1. 项目 代码块 ```语言 公式块 $$ 行内公式 $公式$ 标签 #标签（无空格） 分隔线 --- ─────────────────────────────────────────────
