markdown 换行_你可能不知道的 Markdown 骚操作(附最新GFM规范)

前言

Markdown 是我们广大程序员最熟悉的一门语言之一,因为它易读,语义化等特点,被我们广泛用于文档编写中,可以说是和 JSON 相提并论的一种通用语法。

可你是否知道,Markdown 其实玩出很多骚操作呢?今天,我们用基于 CommonMark 的 GFM 规范为例,给大家总结了以下的骚操作。

正文

操作一:Tab 不等效空格的情况

图片中的 -> 即代表 tab 键

在 Markdown 中,一个 Tab 和四个空格通常是等效的。

cfb768c4371070b596fd63c98227fafd.png

示例代码

- foo

    bar

但如果 tab 作为文字内部的字符传递,就不会等效为四个空格。

8565bc50fcaca13294f3c62764167286.png

示例代码

foo    baz        bim

操作二:在围栏代码块里显示三个 `

我们有的时候需要在 Markdown 中编写一个 Markdown 的代码块,就像这样:

```js
const a = 2;
```

这时候围栏如果还是用三个 ` 的话,会解析失败。其实我们还可以用 ~ 来做代码块的围栏。

c249b76e8a39bc90c73087e7a96ce70f.png

示例代码

~~~
aaa
```
~~~

当然,还有你要坚持用 `,也可以,只要让外层的围栏长度更长一些即可:

9bf722b1a37e554f9071a714b7b2c788.png

示例代码

````
aaa
```
``````

操作三:围栏可以缩进

如果起始围栏是缩进的,则内容行将删除等效的起始缩进(如果存在的话):

08beee3f00c227275fc676a4423acc63.png

feb0bb6d199fc2b01d9dcae7fabc86c3.png

71df0a2dfc35ae31c9b557b74085ff4c.png

示例代码

```
 aaa
aaa
```
```
aaa
  aaa
aaa
  ```
```
   aaa
    aaa
  aaa
   ```

操作四:在 Markdown 中写注释

你以为 Markdown 写出来的东西都是明文吗?其实并不然,因为兼容 HTML 的原因,所以 HTML 格式的注释也是支持的:

27fa96ecc4e720f559d087b7f34ba5de.png

示例代码

foo <!-- this is a
comment - with hyphen -->

操作五:可以在 HTML 中包含 Markdown 内容

只需使用空行将 Markdown 与 HTML 分开:

47d0d01c4b135858b39aa543b47d0811.png

示例代码

<div>

*Emphasized* text.

</div>

操作六:使用链接引用定义避免重复写链接地址

有时候,我们一篇文章会出现很多个重复链接,这时候,我们可以使用链接引用定义来避免重复写链接地址:

5b60ff3e556fcfe86a2868ccb2cfc22f.png

示例代码

[foo]: /url "title"

[foo]

操作七:表格行的单元格数量上可以有所不同

表格不同行的部分可以在单元格数量上有所不同。如果有多个单元格小于标题行中的单元格数,则插入空单元格。如果有多的,则忽略多余的:

8d0370ae735c41033f158d5be6b17036.png

示例代码

| abc | def |
| --- | --- |
| bar |
| bar | baz | boo |

操作八:块引用的延迟原则

块引用的延迟原则可以使我们省略段落延续文本前面的 >:

78d2071e8d186d7d243f3a86327a2298.png

示例代码

> # Foo
> bar
baz

操作九:多个块引用放到一起,会得到一个大的块引用

这称为块引用的持续性。

4e959bb1dc363f87cfc1a30a58ac8cea.png

示例代码

> foo
> bar

操作十:起始序号可以用 0 开头:

442bc2883a8ccbbf39b43fb56423af86.png

示例代码

0. ok

操作十一:改变无序或者有序列表的分隔符会另起新列表

ac776582baadb558c6c5240487f2bbb7.png

示例代码

- foo
- bar
+ baz

操作十二:强制换行

方法一:在行末加上反斜杠会被认为是强制换行

43acb9146a066398b7a33409b7d62a2f.png

示例代码

foo
baz

但在段落或其他块元素的末尾,这种方法不起作用:

2b8d60e254e8244f2321d9558afe1efe.png

方法二:可以在行尾使用两个或多个空格

d43f3cf3a17fdde0a3b996498c2adf77.png

示例代码

foo  
baz

操作十三:小心使用强调分隔符和标点符号一起的情况

左侧分隔符后面出现标点符号,前面出现字母或数字。或者右侧分隔符前面出现标点符号,后面出现字母或数字不算强调:

1dab9e1f32383044757b3837e3e75680.png

示例代码

a*"foo"*

操作十四:强调可以嵌套

a87651af77037e2bb6364902ab9ba5a7.png

示例代码

_foo __bar__ baz_

操作十五:链接标签不区分大小写

5dedfce88903664df04feaa759e7ebc9.png

示例代码

[Foo]

[foo]: /url "title"

结语

Markdown 是一门方便的编写结构化文档的语言。在熟悉了基本语法后再抽空去了解一下规范,可以使我们在日常的文档编写中效率更高。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值