你真的会用 Markdown 吗?

 

2019-10-03

之前已经对常用的 Markdown 语法进行整理,但之后又学会了几个小技巧,只是未同步更新,所以这次趁着对 Life of Py 重新整理,顺做下记录。

列表

列表可以增加描述,就像 Workflowy 一样:

  • 《我是个年轻人,我心情不太好》
    • 【树林】 已经说了,我有一辆好自行车。有许多变速挡,装了一对大车蹬子。我骑车所向披靡,一骑上车我就是个流氓。
    • 【旅行】 我还是不知道世界万物之间的联系,或者一切最终是不是都会好起来。 但我相信有些事情是有意义的。 我相信灵魂在游戏和玩耍的过程中得到了净化。 我还相信爱。
  • 我是个年轻人,并且心情不太好。

换行并空四格,后面的文字缩进便同列表一样:

1
- 《我是个年轻人,我心情不太好》
2
- 【树林】
3
已经说了,我有一辆好自行车。有许多变速挡,装了一对大车蹬子。我骑车所向披靡,一骑上车我就是个流氓。
4
- 【旅行】
5
我还是不知道世界万物之间的联系,或者一切最终是不是都会好起来。
6
但我相信有些事情是有意义的。
7
我相信灵魂在游戏和玩耍的过程中得到了净化。
8
我还相信爱。
9
- 我是个年轻人,并且心情不太好。

链接

title 属性

链接除了常用的 [描述](URL) 之外,还可以增加 Title 描述:

[长风](https://note.wuze.me "长风的 Blog")

当鼠标悬浮在链接 长风 的时候,会出现提示。

参考式

参考式链接类似于脚注,分为两部分:

  1. [长风][wind]
  2. [wind]: https://wuze.me

效果和 [描述](URL) 一样:长风,第二个括号的识别符可以用中文,而且也一样支持 title 属性。此外,当省略第二个括号的识别符时,将使用第一个括号作为识别符:

  1. [长风][]
  2. [长风]: https://wuze.me

锚点

发现之前的那篇 Markdown 语法及个人书写风格指南 v2 没有关于锚点,在这里补充上。

因为 Bitcron 对标题的默认锚点 ID 是数字形式的,这就导致当增加或减少标题时锚点 ID 也会随之改变,所以 Bitcron 的锚点 ID 基本上就是个摆设。

既然如此,只能借助 HTML 标签来实现,不过在这之前可以先实现回到页面顶部的方法,很简单,增加一句:[回到顶部](#) 便可实现,可以点击这里试试 回到顶部

借助 HTML 标签实现的自定义锚点:

1
<span id="anchor">锚点一号</span>

使用方法和链接一样 [锚点一号](#anchor) 如果想做隐藏式的,直接把标签之间的文字删除即可,像这样 列表,便可以跳到列表的位置。

最后

Life of Py 有对主要的 Markdown 进行汇总。