MarkDown 的常用高阶教程

写在前面

接触 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 编辑器中的清流

Typora
  • 简洁、好看、好用
  • 书写实时显示格式
  • 可免费导出 PDF
所写即所得

写简历的时候,再也不用再网上转换了,直接转就行了,非常好用。官网安装教程与中文详细介绍在这:

Typora 官网

yiekue - 安利一下Typora:极致简洁的markdown编辑器

Everything

瞬间给你想要

  • 安装包极小,占用内存极低
  • 快捷键瞬开,平时感受不到存在
  • 毫秒级搜索,秒杀 Windows 资源管理器搜索
瞬搜

这个是真的方便,实在忘记某个文件放在哪后,只要记一点文件名就行了,官网在这:

Everything 官网

参考资料

Markdown: Syntax 英文官方文档

Markdown 简明中文版

陈满iOS - 程序员修养·Markdown语法学习手册


个人博客:www.iamxiarui.com

原文链接:http://www.iamxiarui.com/?p=1096

你可能感兴趣的:(MarkDown 的常用高阶教程)