目录 - Table of Contents

Markdown的高级功能

引用区块

如果你引用了大段的文本,可以使用 > 来表示引用的文本。
示例:
> 这是一个引用区块
引用区可以拥有多行
> > 并且引用区支持嵌套
但是如果空出了两行,则引用区会立刻失效

这一行开始结束引用区块
效果:
这是一个引用区块
引用区可以拥有多行
并且引用区支持嵌套
但是如果空出了两行,则引用区会立刻失效
这一行开始结束引用区块

代码块

分享代码其实很简单,如果只是单纯的一行代码,可以用 `代码文本` 来表示,如 <p>一段html代码</p>
这样的好处是方便简洁,但缺点是没有代码染色、不适用于多行代码。
如果我有大段的代码需要复制,那该怎么办呢?
也很简单,用三个重音符号,搭配代码类型描述文本,将代码段包覆起来即可,如下:
```代码类型
代码文本
……
```
如我想发布一段VB.NET的代码
```vb.net
Dim s As String
s = "Hello World"
Msgbox(s)
```
效果如下
Dim s As String
s = "Hello World"
Msgbox(s)
怎么样,很简单吧?除了染色之外,还有行号显示!
依此类推,其他代码如 C#、HTML、JS、CSS、PHP 等,都可以用这种方法来染色哦!
如果你只是复制了一段纯文本,也可以用 text 来描述,这样就不会出现行号与代码染色了。
我是一段纯文本
纯文本没有行号
也没有染色功能
另外,每行开头启用4个空格键,也可以将内容视为代码。
不过这个方法没法指定代码的语言,也不方便,所以不推荐您使用。
var s := "???";
double d = 0.1;
int a {return 0;}
Dim i As Integer = 5 + 3
Msgbox(i)

表格

Markdown的表格功能看起来十分复杂,但其实原理很容易。

代码如下:
| 左对齐 | 居中对齐 | 右对齐 |
| :---   | :----:   | ----:  |
| aaaa   |  bbbbbb  | ccccc  |
| a      |     b    |      c |
效果:
左对齐居中对齐右对齐
aaaabbbbbbccccc
abc
分析:
表格采用竖线来区分边界,并且需要与其他内容分隔两行以上。
第一行是表格的名称,必须存在。
第二行是用来确定表格的对齐形式,必须存在。
对齐规则为:左对齐是一个冒号后跟一个以上的减号,居中是用冒号包覆减号,右对齐就是冒号在最右。
减号的数量没有限制,可以用多个减号来美化表格样式。
(PS:其实外围的竖线也没必要,你可以直接写成 内容1 | 内容2 | 内容3

列表与序列

如果你需要一个列表,只要在行首使用星号、加号、减号即可,这些代码是通用的。
* 我是第一行
+ 第二行
- 第三行
效果如下:
  • 我是第一行
  • 第二行
  • 第三行
那为什么要这么麻烦呢?其实这是为了可以递进排序而设计的,比如下面的代码:
* 1
    + 1.5
* 2
    + 2.3
        - 2.5
    + 2.8
* 3
效果:
  • 1
    • 1.5
  • 2
    • 2.3
      • 2.5
    • 2.8
  • 3
这样便可以让列表具有递进关系与层级,美观又实用!


数字列表的话只需要以数字加一个点就可以了,但数字并不重要,Markdown会自动递增数值。
比如:
10. 第一行,但数字总是从1开始
13. 第二行,数字没用
19. 第三行
效果:
  1. 第一行,但数字总是从1开始
  2. 第二行,数字没用
  3. 第三行
但这种方式极易误触MD的自动解析,所以如果你的文档是以数字和点号作为开头,一定要记得用反斜杠来注释点号,如:
示例 1986\. What a great season.
效果 1986. What a great season.

更多Markdown语法参考

https://www.markdown.cn
https://www.jianshu.com/p/q81RER

下一页介绍一些简易HTML语法