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

Markdown简介

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

一、段落

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

示例代码如下

第一段

第二段

显示效果如下

第一段

第二段

二、标题

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

示例代码如下

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

显示效果如下

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

三、列表

有序列表

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

示例代码如下

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

显示效果如下

  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个空格

十四、表格

语法:

  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. 注释内容演示,见十二条内容。