之前在这篇文章里说过,用Typecho的主要原因,是想用Markdown了。用Markdown写作是一件省心省力的事,虽然语法简单,但刚开始用,偶尔也有记不住的时候,下面做个整理备注。

Markdown简介

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。由于各平台使用的Markdown处理器的不同,支持的语法元素也会有一些区别,但基础的语法都是一样的。

一、段落

语法:两个段落之间使用空行分隔。注意:换行不是分段的标识,空行才是。

示例代码如下

第一段

第二段

显示效果如下

第一段

第二段

二、标题

语法:使用连续的 # 表示标题,根据 # 的数量不同,标题大小级别也不同。(#号后面加不加空格无所谓,加空格主要是为了美观。)

示例代码如下

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果如下

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

三、列表

有序列表

语法:使用 数字 + . 作为项目符号,项目符号和正式列表项目之间有一个空格。

示例代码如下

1. 有序列表
2. 有序列表
3. 有序列表

显示效果如下

  1. 有序列表
  2. 有序列表
  3. 有序列表

有序列表套嵌

示例代码如下

1. 有序列表
 1. 有序列表
 2. 有序列表

显示效果如下

  1. 有序列表

    1. 有序列表
    2. 有序列表

无序列表

语法:使用 * 作为项目符号,项目符号和正式列表项目之间有一个空格。(使用符号 + 或 - 也可以,显示效果相同)

示例代码如下

* 无序列表
* 无序列表
* 无序列表

显示效果如下

  • 无序列表
  • 无序列表
  • 无序列表

无序列表套嵌

示例代码如下

* 无序列表
 * 无序列表
 * 无序列表

显示效果如下

  • 无序列表

    • 无序列表
    • 无序列表

四、分割线

语法:使用 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个空格

十四、表格

语法:

  1. 第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
  2. 列于列之间用管道符 | 隔开。表格每一行两边的管道符可省略,但写上也可以,更美观。
  3. 第二行还可以为不同的列指定对齐方向。标题默认为居中对齐,内容默认为左对齐;在 - 左边加上 : 就 是左对齐;在 - 右边加上 : 就是右对齐;在 - 两边都加上 : 就是居中对齐。— 可以写多少,也可以只写一个。

示例代码如下

|姓名|语文成绩|数学成绩|总成绩|
|:---:|:---:|:---:|:---:|
|喜羊羊|100|120|220|
|懒羊羊|0|0|0|

显示效果如下

姓名语文成绩数学成绩总成绩
喜羊羊100120220
懒羊羊000

十五、其他问题

Markdown 与 HTML 的关系

  1. HTML 是一种发布的格式,Markdown 是一种书写的格式。
  2. Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
  3. 在 Markdown 中可直接使用 HTML 标签

十六、待办事项

Typecho的Markdown不支持该语法,故用html语法实现

示例代码如下

<input type="checkbox" checked>待办事项1</input>
<input type="checkbox">待办事项2</input>

显示效果如下
待办事项1
待办事项2


  1. 注释内容演示,见十二条内容。