Markdown语法学习

Markdown语法学习

简单介绍Markdown的基础语法和扩展语法GFM

1 基础语法

所有的标记符号必须是半角(英文)标点符号

1.1 字体

• 标题
  • 语法:底线(—)和#
  • 标题格式 “# + 空格 + 标题内容”
    • 行首插入#
    • "#"的个数 = 标题的等级
    • #后面加个空格
    • 最多六级标题
  • 使用规范
    • 只是用#
    • 建议标题前后都空一行,除非在文首
    • "#"与文本间空一格
    • "#"的前后不要有标点符号
    • 标题尽量简短
• 粗体与斜体
  • 粗体,两个-或两个*包裹
  • 斜体,一个-或一个*包裹
  • 建议只使用*

1.2 段落与换行

• 列表
  • 有序列表,数字 + 英文句点 +空格 + 列表内容
  • 无序列表,*/+/- + 空格 + 列表内容
  • 嵌套列表,下侧列表前按tab
  • 有序列表和无序列表可以互相嵌套
• 分割线
  • 3个或3个以上的*/-来标记
  • 行内不能有其他的字符
  • 可以在标记符中间加上空格

1.3 图片

• 语法,! + [] + ()
  • 图片替代文字可以为空
  • 图片地址,可以是本地路径,但建议为网络地址

1.4 文字

• 文字链接
  • 语法,[] + ()
  • 连接过多后,可读性变差
• 引用连接
  • 语法,[链接文字][链接标记]；[链接标记]:链接地址
  • 链接标记不区分大小写
  • 定义的链接建议放在页尾
  • 链接地址必须以http/https开头
• 网络连接
  • 语法,"< + URL + >"
  • 链接标记要有意义
  • 网络地址无需以http或https开头

1.5 行内代码与代码块

• 行内代码
  • 用 ` 包裹
• 代码块
  • 用3个 ` 包裹
• 使用规范
  • 转义或强调某些字符时,也可以用 ` 包裹
  • 代码超过一行时,建议使用代码块
  • 使用围栏代码块,3个`开头

1.6 引用

• 语法,> + 引用内容
  • 多行引用,在每一行开头都插入>
  • 引用可以嵌套

2 扩展语法GFM

GFM,GitHub Flavored Markdown

2.1 删除线

• 语法 ,两个~~包裹,
• 被删除

2.2 表情

• 语法,用 : 包裹起来,
• 😄

2.3 表格

• 语法

|表头1|表头2|表头3|
|-|-|-|
|内容1|内容2|内容3|

表头1	表头2	表头3
内容1	内容2	内容3

• 说明
  • 单元格用 | 分隔,最前和最后都是用 |
  • 单元格之间的空格会被移除
  • 表头与其他行用 — 来分隔
  • 表格对齐方式
    • 左对齐, :…
    • 右对齐,…:
    • 居中对齐,:…:
  • 块级元素不能插入到表格中

2.5 任务列表

• 语法,- + 空格 + [空格/X/x] + 空格 +文字内容
• 你好

2.6 锚点

[锚点描述][#锚点名]
锚点名不能有空格和特殊符号

附

1. Markdown数学公式语法

Markdown数学公式语法