写在前面
接触 Markdown (以下用 MD 代替)已经有快两年,最早接触时震撼于其强大的书写格式,现在已经养成日常的文档编辑习惯。比如现在公司的代码规范、入职指南、内部平台教程与需求文档,我全部用 MarkDownPad 2 编写,然后转成 HTML 格式,阅读的人无不称赞其格式的优雅,而且更大的好处是从源头上杜绝了由于 Office 版本(甚至是想不开用 WPS )兼容问题造成的文档格式变化问题,更重要的是 HTML 可以直接存入浏览器书签,再也不用在资源管理器找来找去了。当然如果你安装了 Everything 的话,当我没说。
话说回来,在 IT 行业,应该很少有人不知道 MD 格式的吧。MD 的基本语法大家都能熟练掌握,但是有些非常常用的进阶语法或者说小技巧不见得每个人都知道,所以现在就来说几种不仅进阶且非常常用的 MD 语法吧。以下是文章目录:
- 写在前面
- 常用高阶语法
- 表格的使用
- 页内链接跳转
- 本地文件链接
- 高效率软件推荐
- 参考资料
常用高阶语法
表格的使用
第一个比较常用的语法就是表格,网上也有很多教程,现在就来总结一下。它的语法如下:
|第一列|第二列|第三列|
|:-:|:-|-:|
|第一列是居中的|第二列是居左的|第三列是居右的|
可以看出其实最重要的是|:-:|:-|-:|
这一行,如果要写表格,此行不可以省略,也就是说必须要写,但怎么写在于表格所需要的格式。
1、列名称
首先如果此行上面不写的话,那就没有表列名称,比如:
|:-:|:-|-:|
|第一列是居中的|第二列是居左的|第三列是居右的|
不支持不写列名的表格,所以我截图了,可以与上面的表对比看出,现在的表没有了每一列的名称,一般来说,都是需要写的,注意,列名已经默认字体加粗了。
2、内容位置
细心的同学可能发现第二行中间有很多冒号,没错这就是控制表中内容是居中、居左还是居右的语法。可以把冒号看成是表的单元格的边界,而短横线相当于表单元格中的内容,比如:
-
:-:
: 相当于内容被左右两个边界包裹,这就是居中 -
:-
: 相当于内容靠近左边界,这就是居左 -
-:
: 相当于内容靠近右边界,这就是居右
现在看之前的表格就清楚多了吧,表格语法就是这么简单。
3、注意事项
- 有的教程里面把短横线画了很多,其实没有必要,只需要一个就行了,甚至居中
:-:
中的短横线都可以省略。 - Github 上面的 README.md 中必须要写短横线,不然识别不出来。
- 用 MarkDownPad 2 软件写表格的话,记得把处理器改成扩展,不然没有效果。
页内链接跳转
啥叫页内链接跳转呢,其实就是文章开头的目录,点击章节名,可以在页内跳转。那应该如何实现呢?
先说一下,其实 MD 就是一种标签格式语言, HTML 所具备的一些格式, MD 同样兼容。比如下面的两条语法其实是一样的,同样代表二级标题:
##测试标题
测试标题
此外我们知道 MD 中链接的格式是 []()
,前面的中括号是标题,后面的小括号是链接。假如实现页内跳转的话,链接一定是页内链接,那该如何写呢。注意在 HTML 中,标题可以设置其 id 属性,也就是这样 ,这个 id 恰好就是我们需要的页内链接。
好了,来看具体写法:
* [写在前面](#1)
* [常用高阶语法](#2)
* [表格的使用](#3)
* [页内链接跳转](#4)
* [本地文件链接](#5)
* [高效率软件推荐](#6)
* [参考资料](#7)
写在前面
常用高阶语法
表格的使用
页内链接跳转
本地文件链接
软件推荐
参考资料
可以看到在目录中后面的链接写法是 # + 标号
,这个标号其实就是标题中的 id ,只要一一对应起来,就可以实现页内跳转了,是不是很简单呢?效果就不展示了,文章已经使用了这种方式,大家可以试一试。
本地文件链接
从上面可以学到如何实现页内链接跳转,那如何实现本地文件链接呢,也就是如何点击后打开本地文件夹呢,这个就比较简单了,看下面的写法就懂了:
[博客文件路径](file:///F:/博客/md)
没错就是在文件或文件夹的路径前面加上file:///
就行了,注意路径为文件或文件夹的绝对路径,而且反斜杠需要转义,这个应该很好理解吧,不再解释。
这个语法的使用场景不多,毕竟每个人的文件夹路径不一样,主要使用在公司的共享文件夹中,能快速定位到目录,方便快捷。
软件推荐
好了,就介绍这三个常用的语法,其他的高阶语法使用不多,如果有需求的话,可以阅读官方文档或者看后面比较好的参考资料。现在来介绍几款非常好用且提高效率的软件。
Typora
众多 Markdown 编辑器中的清流
- 简洁、好看、好用
- 书写实时显示格式
- 可免费导出 PDF
写简历的时候,再也不用再网上转换了,直接转就行了,非常好用。官网安装教程与中文详细介绍在这:
Typora 官网
yiekue - 安利一下Typora:极致简洁的markdown编辑器
Everything
瞬间给你想要
- 安装包极小,占用内存极低
- 快捷键瞬开,平时感受不到存在
- 毫秒级搜索,秒杀 Windows 资源管理器搜索
这个是真的方便,实在忘记某个文件放在哪后,只要记一点文件名就行了,官网在这:
Everything 官网
参考资料
Markdown: Syntax 英文官方文档
Markdown 简明中文版
陈满iOS - 程序员修养·Markdown语法学习手册
个人博客:www.iamxiarui.com
原文链接:http://www.iamxiarui.com/?p=1096