Markdown语法整理

• 最近在学习使用 Logseq，顺便整理了一份 Markdown 语法指南，涵盖常用格式与符号说明。

• 一、标题（Heading）

  用于划分文本层级，Markdown 支持 6 级标题，用 # 表示，层级由 # 数量决定（# 越多，标题等级越低）。
  语法示例：

  # 一级标题（最大）
  ## 二级标题
  ### 三级标题
  #### 四级标题
  ##### 五级标题
  ###### 六级标题（最小）
  

  效果：

• 一级标题（最大）

• 二级标题

• 三级标题

• 注意：“ # ”后面一定要加上一个空格否则没有效果。

• 二、段落与换行

• 段落：直接输入文本，段落间用 回车 分隔（无需额外符号）。

• 换行：在文本末用 shift + 回车，或使用 <br> 标签。
  效果：
  这是一个段落。

• 这是另一个段落（段落效果）。

  这是第一行文本，
  这是第二行文本（换行效果）。

• 三、字体样式

  效果	语法	示例	显示效果
  加粗	**文本** 或 __文本__	**加粗文字**	加粗文字
  斜体	*文本* 或 _文本_	*斜体文字*	斜体文字
  加粗斜体	***文本*** 或 ___文本___	***加粗斜体文字***	加粗斜体文字
  删除线	~~文本~~	~~删除线文字~~	删除线文字
  行内代码	文本	print(“Hello”)	print("Hello")

• 四、列表（List）

• 1. 无序列表

  用 -、+ 或 * 开头，后跟空格。
  语法示例：

  - 列表项 1  
  - 列表项 2  
  - 子列表项（缩进 2 个空格）  
  - 列表项 3  
  

  效果：

• 列表项 1

• 列表项 2

  • 子列表项（缩进 2 个空格）

• 列表项 3

• 2. 有序列表

  用数字 1.、2. 等开头，后跟空格（数字可非连续，Markdown 会自动渲染为连续序号）。
  语法示例：

  1. 第一项  
  2. 第二项  
  3. 第三项  
  

  效果：

  1. 第一项
  2. 第二项
  3. 第三项

• 五、链接（Link）

• 1. 超链接

  格式：[链接文本](链接地址 "提示文本")（提示文本可选）。
  示例：

  访问 [百度](https://www.baidu.com "点击跳转百度")  
  

  效果：
  访问 百度

• 2. 图片链接

  格式：![图片描述](图片地址 "提示文本")（描述不可省略，否则影响无障碍阅读）。

• 六、引用（Blockquote）

  用 > 开头，表示引用内容（可嵌套，用 >> 表示次级引用）。
  语法示例：

  > 这是一段引用内容。  
  > > 这是嵌套引用。  
  

  效果：

  这是一段引用内容。

  这是嵌套引用。

• 七、代码块（Code Block）

• 1. 行内代码

  用 包裹单个代码片段，如： variable = 10 `。

• 注意：不同输入法打出“```”的方式略有不同。

• 2. 代码块

  用 ```包裹多行代码，可指定编程语言（可选，用于语法高亮）。
  语法示例：

  print(“Hello, World!”)
  for i in range(5):
  print(i)

  效果（带语法高亮）：

  print("Hello, World!")  
  for i in range(5):  
    print(i)
  

• 八、表格（Table）

  用 | 分隔列，用 -（至少 3 个）分隔表头和内容，对齐方式用 : 标记（左对齐 :-，右对齐 -:，居中 :-:）。
  语法示例：

  | 姓名   | 年龄 | 职业       |  
  |--------|------|------------|  
  | 张三   | 25   | 工程师     |  
  | 李四   | 30   | 设计师     |  
  

  效果：

  姓名	年龄	职业
  张三	25	工程师
  李四	30	设计师

• 九、分隔线（Horizontal Rule）

  用 ---、*** 或 ___（连续 3 个及以上）表示，需单独占一行。
  语法示例：

  文本内容  
  ---  
  新的章节内容  
  

  效果：
  文本内容

新的章节内容

• 十、转义字符

  若需显示 Markdown 符号本身（如 #、* 等），需在符号前加 \ 转义。
  示例：

  \. 显示点号  
  \* 显示星号  
  

  效果：
  . 显示点号

  • 显示星号

• 常用快捷键（以 Logseq 为例）

  操作	快捷键
  一级标题	Ctrl + 1
  加粗	Ctrl + B
  斜体	Ctrl + I
  代码块	Ctrl + Shift +
  引用块	Ctrl + Shift + Q
  链接	Ctrl + L
  图像	Ctrl + shift + I

  掌握这些基础语法后，即可满足日常文本排版需求。如果需要更复杂的功能（如脚注、数学公式等），可进一步学习 Markdown 扩展语法（如 GitHub Flavored Markdown）。

  本文基于个人经验整理，难免存在疏漏或错误。如果发现内容有误或表述不清晰的地方，欢迎在评论区留言指正，非常感谢！😊