自从几年前开始在 GitHub 玩耍,接触到 Markdown 之后,就一发不可收拾,在各种文档编辑上,有条件用 Markdown 的尽量用,不能用的创造条件也要用——README、博客、公众号、接口文档等等全都是,比如当前这篇文章就是用 Markdown 编辑而成。

4.jpg

这几年也发现越来越多的网站和程序提供了对 Markdown 的支持,从最初接触的 GitHub、Jekyll,到简书、掘金、CSDN 等等,由此也从别人做得好的文档中,学到了一些【奇技淫巧】,所以本文不是对 Markdown 基础语法的介绍,而是一些相对高级、能将 Markdown 玩出更多花样的小技巧。

附赠 MarkDown 基本语法参考图

附赠 MarkDown 基本语法参考图

注:如下技巧大多是利用 Markdown 兼容部分 HTML 标签的特性来完成,不一定在所有网站和软件里都完全支持,主要以 GitHub 支持为准。

在表格单元格里换行

借助于 HTML 里的
实现。

示例代码:

| Header1 | Header2 |
|---------|----------------------------------|
| item 1 | 1. one<br />2. two<br />3. three |
示例效果:

Header1Header2
item 11. one
2. two
3. three

格式化表格

表格在渲染之后很整洁好看,但是在文件源码里却可能是这样的:

|Header1|Header2|
|---|---|
|a|a|
|ab|ab|
|abc|abc|

不知道你能不能忍,反正我是不能忍。

好在广大网友们的智慧是无穷的,在各种编辑器里为 Markdown 提供了表格格式化功能,比如我使用 Vim 编辑器,就有 vim-table-mode 插件,它能帮我自动将表格格式化成这样:

| Header1 | Header2 |
|---------|---------|
| a       | a       |
| ab      | ab      |
| abc     | abc     |

是不是看着舒服多了?

如果你不使用 Vim,也没有关系,比如 Atom 编辑器的 markdown-table-formatter 插件,Sublime Text 3 的 MarkdownTableFormatter 等等,都提供了类似的解决方案。

行首缩进

直接在 Markdown 里用空格和 Tab 键缩进在渲染后会被忽略掉,需要借助 HTML 转义字符在行首添加空格来实现, 代表半角空格,  代表全角空格。

示例代码:

&emsp;&emsp;春天来了,又到了万物复苏的季节。

示例效果:

  春天来了,又到了万物复苏的季节。

任务列表

在 GitHub 和 GitLab 等网站,除了可以使用有序列表和无序列表外,还可以使用任务列表,很适合要列出一些清单的场景。

示例代码:

**购物清单**

- [ ] 一次性水杯
- [x] 西瓜
- [ ] 豆浆
- [x] 可口可乐
- [ ] 小茗同学

示例效果:
购物清单

  • [ ] 一次性水杯
  • [x] 西瓜
  • [ ] 豆浆
  • [x] 可口可乐
  • [ ] 小茗同学

后话

好了,这一波的奇技淫巧就此告一段落,希望大家在了解这些之后能有所收获,更好地排版,专注写作。

因为 Typecho 的最新开发版采用的 MarkDown 引擎是 HyperDown ,所以明月整理的这些奇技淫巧都是在 Typecho 的原生编辑器里测试过的(具体大家可以看到示例就是证明)。目前 Typecho 开发版17.10.13已经支持了“任务列表”,值得欣慰哦!

最后修改:2017 年 10 月 21 日
如果觉得我的文章对你有用,请随意赞赏