Markdown语法说明汇总
之前在这篇文章里说过,用Typecho的主要原因,是想用Markdown了。用Markdown写作是一件省心省力的事,虽然语法简单,但刚开始用,偶尔也有记不住的时候,下面做个整理备注。
Markdown简介
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。由于各平台使用的Markdown处理器的不同,支持的语法元素也会有一些区别,但基础的语法都是一样的。
一、段落
语法:两个段落之间使用空行分隔。注意:换行不是分段的标识,空行才是。
示例代码如下
第一段
第二段
显示效果如下
第一段
第二段
二、标题
语法:使用连续的 # 表示标题,根据 # 的数量不同,标题大小级别也不同。(#号后面加不加空格无所谓,加空格主要是为了美观。)
示例代码如下
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
显示效果如下
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
三、列表
有序列表
语法:使用 数字 + . 作为项目符号,项目符号和正式列表项目之间有一个空格。
示例代码如下
1. 有序列表
2. 有序列表
3. 有序列表
显示效果如下
- 有序列表
- 有序列表
- 有序列表
无序列表
语法:使用 * 作为项目符号,项目符号和正式列表项目之间有一个空格。(使用符号 + 或 - 也可以,显示效果相同)
示例代码如下
* 无序列表
* 无序列表
* 无序列表
显示效果如下
- 无序列表
- 无序列表
- 无序列表
四、分割线
语法:使用 3 个连续的 * 或 - 即可得到一个分割线
示例代码如下
***
显示效果如下
五、引用
语法:在行头加上 > 即可。可以在每行之前加 > ,也可以在段落之前加 1 个 >。引用内部可以添加新的引用,只需再加一个大于号.
示例代码如下
>这是引用
>>引用内部再加引用
显示效果如下
这是引用
引用内部再加引用
六、斜体
语法:使用前后各 1 个 *(或_) 包含的文字是 斜体 文字
示例代码如下
*斜体*
显示效果如下
斜体
七、粗体
语法:使用前后各 2 个 *(或_) 包含的文字是 粗体 文字
示例代码如下
**粗体**
显示效果如下
粗体
八、粗斜体
语法:在 ** 中嵌套 _ ,或者直接前后打3个 ,即可得到 粗斜体。
示例代码如下
***粗斜体***
显示效果如下
粗斜体
九、删除文字
语法:使用前后各 2 个 ~ 包含的文字是删除文字
示例代码如下
~~删除效果~~
显示效果如下
删除效果
十、图片
行内图片
说明:图片和图片地址写在一起。
代码示例如下
![图片标题](图片url)
注意:图片标题可为空
引用图片
说明:图片和图片地址分开书写。
代码示例如下
![图片标题][图片id]
[图片id]:图片url
注意:1.引用图片的 id 在文章中必须唯一
十一、超链接
行内链接
代码示例如下
[苹果](https://www.apple.com "苹果官网")
显示效果如下
苹果
说明:括号里“苹果官网”主要是图片放到链接上会浮现该文字,不需要可以删除,括号里只放链接即可。
引用链接
一种链接和地址分离的方式。
代码示例如下
[链接名称][链接id]
[链接id]:链接 url 地址
举例如下
这个 [苹果][apple] 官网,这是 [谷歌][google] 官网。
[apple]: https://www.apple.com
[google]: http://www.google.com
十二、脚注
为名词提供注释,注释将显示在文章末尾。
代码示例如下
待解释文字[^脚注 id]
[^脚注 id]:注释内容演示,见十二条内容。
显示效果如下
待解释文字1
注意:1.打脚注 id 必须唯一,2.无论脚注 id 如何起名,显示时一律标为数字,并且按出现顺序排列。
十三、代码块
行内代码块
语法:使用两个 ` 将代码包含起来
代码示例如下
在 Java 输出 Hello, world :`System.out.print("Hello, World!");`
显示效果如下
在 Java 输出 Hello, world :System.out.print("Hello, World!");
多行代码块
语法1:使用三个 ` 将代码包含起来
语法2:在行前输入4个空格
十四、表格
语法:
- 第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
- 列于列之间用管道符 | 隔开。表格每一行两边的管道符可省略,但写上也可以,更美观。
- 第二行还可以为不同的列指定对齐方向。标题默认为居中对齐,内容默认为左对齐;在 - 左边加上 : 就 是左对齐;在 - 右边加上 : 就是右对齐;在 - 两边都加上 : 就是居中对齐。— 可以写多少,也可以只写一个。
示例代码如下
|姓名|语文成绩|数学成绩|总成绩|
|:---:|:---:|:---:|:---:|
|喜羊羊|100|120|220|
|懒羊羊|0|0|0|
显示效果如下
姓名 | 语文成绩 | 数学成绩 | 总成绩 |
---|---|---|---|
喜羊羊 | 100 | 120 | 220 |
懒羊羊 | 0 | 0 | 0 |
十五、其他问题
Markdown 与 HTML 的关系
- HTML 是一种发布的格式,Markdown 是一种书写的格式。
- Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
- 在 Markdown 中可直接使用 HTML 标签
十六、待办事项
Typecho的Markdown不支持该语法,故用html语法实现
示例代码如下
<input type="checkbox" checked>待办事项1</input>
<input type="checkbox">待办事项2</input>
显示效果如下
待办事项1
待办事项2
- 注释内容演示,见十二条内容。 ↩