更多可阅读 Markdown 官方文档
均可使用 html 标签替代
# Markdown 基本语法
# 分级语法
#
的数量代表了标题的级别
与 HTML 语法的 <h> 标签一致
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 <!--最多6级标题-->
# 可选语法
可在文本下方添加任意数量的 == 号来标识一级标题,或者 – 号来标识二级标题
<!-- 可理解为: # leve 1 -->
leve 1
======
<!-- 可理解为: ## leve 2 -->
leve 2
------
需要注意 # 与文字有一个空格的间隙
# 段落语法
和通常的打字一样,如果在同行打字换行的就使用 <br>
标签
Hello_World<br>你好世界
效果如下:
Hello_World
你好世界
# 强调语法
# 粗体(Bold)
加粗文本,在短语的前后各添加两个星号 (*) 或下划线 ( _ )
**Hello** __World__
<!-- HTML中则是<strong></strong> -->
效果如下:
Hello World
一般只推荐使用 * 号的方法
# 斜体(Italic)
斜体显示文本,在短语的前后各添加一个星号 (*) 或下划线 ( _ )
*Hello* _World_
<!-- HTML中则是<em></em> -->
效果如下:
Hello World
一般只推荐使用 * 号的方法
# 删除线
若要删除单词,请在单词前后使用两个波浪号~~
~~世界是平坦的。~~ 我们现在知道世界是圆的。
效果如下:
世界是平坦的。 我们现在知道世界是圆的。
# 引用语法
要创建块引用,请在段落前添加一个 > 符号
多个段落块引用就在下面多加一个 > 符号
> 之间可以嵌套块引用只需要多加一个 > 号
> Hello World
> I love you!
>> Good job
实现效果如下:
Hello World
I love you!Good job
同时 > 之间可以使用些不同的语法比如在里面添加 列表
# 列表语法
# 有序列表
1. one
2. two
3. three
...
<!-- 在HTML中则是
<ol>
<li>one</li>
<li>two</li>
<li>three</li>
</ol> -->
效果如下:
- one
- two
- three
# 无序列表
要创建无序列表,需要在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+)
- 1
- 2
- 3
...
<!-- 在HTML中则是
<ul>
<li>one</li>
<li>two</li>
<li>three</li>
</ul> -->
效果如下:
- 1
- 2
- 3
请注意:一般只使用 破折号 (-) 方法
# 任务列表语法
在任务列表项之前添加破折号 - 和方括号 [],并在 [] 前面加上空格
要选择一个复选框,请在方括号 [x] 之间添加 x
- [ ] 任务一 未做任务 `- + (空格) + [ ]`
- [x] 任务二 已做任务 `- + (空格) + [x]`
效果如下:
# 链接语法
# 文字链接
超链接 Markdown 语法代码: [超链接显示名](超链接地址 "超链接title")
链接 title 为可选项,也就是说可写可不写
[Markdown官方语法](https://markdown.com.cn)
<!-- 对应的HTML代码:<a href="超链接地址" title="超链接title">超链接显示名</a> -->
效果如下:
Markdown 官方语法
# Title
链接 title 是当鼠标悬停在链接上时会出现的文字,这个 title 是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔
[UI的Github仓库](https://github.com/ui123456ax/ "Hello! 很高兴能认识你")
效果如下:
UI 的 Github 仓库
# 网址和 Email 地址
使用尖括号可以很方便地把 URL 或者 email 地址变成可点击的链接
<https://github.com/ui123456ax/>
<ui123456ax@gmail.com>
效果如下:
https://github.com/ui123456ax/
ui123456ax@gmail.com
# 带格式化的链接
带 强调
链接
粗体链接 **[我的博客](https://ui123456ax.github.io)**
斜体链接 *[Markdown](https://www.markdownguide.org)*
代码块链接 [`code`](#code)
效果如下:
粗体 我的博客
斜体 Markdown
代码块 code
# 锚点链接
主要为跳转到文章指定 id 的标签处
- 设锚点:标题
- 跳锚点: [文段] (#id)
### 链接语法{#idname}
... 省略
[回到文字链接处](#idname)
[回到文字链接处] (#idname)
以上均可带 Title
# 图片链接
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本
插入图片 Markdown 语法代码: 
- 图片 alt 可以不用写直接空白即可
- 图片 title 可写可不写

<!-- 对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title"> -->
效果图:
# 链接图片
给图片增加链接,将图像的 Markdown 括在方括号中,然后将链接添加在圆括号中
[](https://baike.baidu.com/item/%E5%AD%A4%E7%8B%AC%E6%91%87%E6%BB%9A%EF%BC%81/56105018)
请注意 [ ] 的位置!
# 代码语法
# 表示代码
要将单词或短语表示为代码,请将其包裹在反引号 (`) 中
`你好世界`
<!-- 在HTML中则是<code></code> -->
效果如下:
你好世界
需要转义 (即在代码块显示 ` 符号)
请你输入两个反引号 (``)
# 围栏代码块
根据 Markdown 处理器的不同,在代码块之前和之后的行上使用三个反引号 (```) 或三个波浪号 (~~~)
```JavaScirpt
i = '我爱你,世界'
console,log(i)
```
效果如下:
i = '我爱你,世界'
console,log(i)
要添加语法突出显示,在代码块之前的反引号旁边指定一种语言
比如上面的 "JavaScirpt"如果需要转义代码则在前后多加一个反引号 (````) 或波浪号 (~~~~)
# 分隔线语法
要创建分隔线,需要在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容
***
<!-- 至少是3个 -->
<!-- 与html的<hr>标签一致 -->
效果如下:
推荐使用破折号 (—) 或 HTML 的 < hr > 标签,能很明显的突出
# 内嵌 HTML 标签
正如我开头所说的 Markdown 可以直接使用 HTML 的标签
甚至可以使用部分 CSS 自由装饰你的文本
对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。
你可以把 .html
的文件后缀名改成 .md
完全可以正常打开,并且装饰的 CSS 也会自动使用
不过请注意,Markdown 是支持大部分的 HTML 标签,以及部分的 CSS
在 HTML 块级标签内不能使用 Markdown 语法。例如
<p>italic and **bold**</p>
将不起作用
# Markdown 扩展语法
# 表格
要添加表,请使用三个或多个连字符(—)创建每列的标题,并使用管道(|)分隔每列
可以选择在表的任一端添加管道
| 标题 One | 标题 Two |
| ----------- | ----------- |
| Hello? | Yes? |
| 你好 | 是的 |
<!-- 单元格宽度可以变化 -->
呈现的输出如下所示:
标题 One | 标题 Two |
---|---|
Hello? | Yes? |
你好 | 是的 |
# 对齐
您可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心
| 标题 One | 标题 Two | 标题 Three |
| :--- | :----: | ---: |
| Left | Title | Right |
| left | Text | right |
呈现的输出如下所示:
标题 One | 标题 Two | 标题 Three |
---|---|---|
Left | Title | Right |
left | Text | right |
# 格式化表格中的文字
可以在表格中设置文本格式。例如,您可以添加链接,代码(仅反引号(`),而不是代码块)和强调
不能添加标题,块引用,列表,水平规则,图像或 HTML 标签
# 脚注
带有脚注的上标数字会出现在添加脚注参考的位置 读者可以单击链接以跳至页面底部的脚注内容
创建脚注参考,方括号 [^1]
内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符
脚注使您可以添加注释和参考,而不会使文档正文混乱
在括号内使用另一个插入符号和数字添加脚注,并用冒号和文本[^1]: 解释.
这是一个脚注[^2],这是一个更长的脚注[^你好]
<!-- 脚注将出现在文章末尾 -->
[^2]:我是一个脚注的
[^你好]:我是第二个脚注的脚注
欸,`好吧好吧`
# 使用 Emoji 表情
一些 Markdown 应用程序允许您通过键入表情符号短代码来插入表情符号
这些以冒号开头和结尾,并包含表情符号的名称
去露营了! :tent: 很快回来。
[点我查看更多表情](https://gist.github.com/rxaviers/7360908)
真好笑! :joy:
效果如下:
去露营了! ⛺️ 很快回来。
点我查看更多表情
真好笑! 😂
表情符号会因应用程序而异