3 基础Markdown语法的使用
3.1 标题
在文字写书写不同数量的#
可以完成不同的标题,如下:
一级标题
代码为# 一级标题
二级标题
代码为## 二级标题
三级标题
代码为### 三级标题
3.2 无序列表
无序列表的使用,在符号-
后加空格使用。如下:
代码为:
- 无序列表 1
- 无序列表 2
- 无序列表 3
如果要控制列表的层级,则需要在符号-
前使用空格。如下:
代码为:
- 无序列表 1
- 无序列表 2
- 无序列表 2.1
- 无序列表 2.2
3.3 有序列表
有序列表的使用,在数字及符号.
后加空格后输入内容,如下:
- 有序列表 1
- 有序列表 2
- 有序列表 3
代码为:
1. 有序列表 1
2. 有序列表 2
3. 有序列表 3
3.4 引用
引用的格式是在符号>
后面书写文字。如下:
读一本好书,就是在和高尚的人谈话。 ——歌德
代码为:
> 读一本好书,就是在和高尚的人谈话。 ——歌德
3.5 粗体和斜体
粗体的使用是在需要加粗的文字前后各加两个*
。
而斜体的使用则是在需要斜体的文字前后各加一个*
。
如果要使用粗体和斜体,那么就是在需要操作的文字前后加三个*
。如下:
这个是粗体
这个是斜体
这个是粗体加斜体
代码为:
**这个是粗体**
*这个是斜体*
***这个是粗体加斜体***
注:由于 commonmark 标准,可能会导致加粗与想象不一致,如下
**今天天气好晴朗,**处处好风光。
这个是正常现象,请参考加粗 Issue。
3.6 链接
链接的使用方法为[链接标题](链接网址)
。例子如下所示:
为方便读者查阅【精算后花园】公众号往期文章,Jackie将文章分门别类汇总此处【精算后花园】博客文章合集目录
3.7 分割线
可以在一行中用三个以上的减号---
来建立一个分隔线,同时需要在分隔线的上面空一行。如下:
3.8 删除线
删除线的使用,在需要删除的文字前后各使用两个~
,如下:
这是要被删除的内容。
代码为:
~~这是要被删除的内容。~~
3.9 表格
可以使用冒号来定义表格的对齐方式,如下:
姓名 |
年龄 |
工作 |
小可爱 |
18 |
吃可爱多 |
小小勇敢 |
20 |
爬棵勇敢树 |
小小小机智 |
22 |
看一本机智书 |
代码为:
| 姓名 | 年龄 | 工作 |
| :----- | :--: | -------: |
| 小可爱 | 18 | 吃可爱多 |
| 小小勇敢 | 20 | 爬棵勇敢树 |
| 小小小机智 | 22 | 看一本机智书 |
3.10 图片
插入图片,如果是行内图片则无图例,否则有图例,格式如下:

代码为:

支持 jpg、png、gif、svg 等图片格式,其中 svg 文件仅可在微信公众平台中使用,svg 文件示例如下:

3.11 代码块
如果在一个行内需要引用代码,只要用反引号引起来就好,如下:
Use the printf()
function.
代码为:
Use the `printf()` function.
在需要高亮的代码块的前一行及后一行使用三个反引号,同时第一行反引号后面表示代码块所使用的语言,如下:
// FileName: HelloWorld.java
public class HelloWorld {
// Java 入口程序,程序从此入口
public static void main(String[] args) {
System.out.println("Hello,World!"); // 向控制台打印一条语句
}
}
支持以下语言种类:
bash
clojure,cpp,cs,css
dart,dockerfile, diff
erlang
go,gradle,groovy
haskell
java,javascript,json,julia
kotlin
lisp,lua
makefile,markdown,matlab
objectivec
perl,php,python
r,ruby,rust
scala,shell,sql,swift
tex,typescript
verilog,vhdl
xml
yaml
diff 不能同时和其他语言的高亮同时显示,且需要调整代码主题为微信代码主题以外的代码主题才能看到 diff 效果,使用效果如下:
+ 新增项
- 删除项