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 同样兼容。比如下面的两条语法其实是一样的,同样代表二级标题:

##测试标题
<h2>测试标题</h2>

此外我们知道 MD 中链接的格式是 []() ,前面的中括号是标题,后面的小括号是链接。假如实现页内跳转的话,链接一定是页内链接,那该如何写呢。注意在 HTML 中,标题可以设置其 id 属性,也就是这样 <h2 id=""></h2> ,这个 id 恰好就是我们需要的页内链接。

好了,来看具体写法:

* [写在前面](#1)
* [常用高阶语法](#2)
    * [表格的使用](#3)
    * [页内链接跳转](#4)
    * [本地文件链接](#5)
* [高效率软件推荐](#6)
* [参考资料](#7)

<h2  id="1">写在前面</h2>
<h2 id="2">常用高阶语法</h2>
<h3 id="3">表格的使用</h3>
<h3 id="4">页内链接跳转</h3>
<h3 id="5">本地文件链接</h3>
<h2 id="6">软件推荐</h2>
<h2 id="7">参考资料</h2>

可以看到在目录中后面的链接写法是 # + 标号 ,这个标号其实就是标题中的 id ,只要一一对应起来,就可以实现页内跳转了,是不是很简单呢?效果就不展示了,文章已经使用了这种方式,大家可以试一试。

本地文件链接

从上面可以学到如何实现页内链接跳转,那如何实现本地文件链接呢,也就是如何点击后打开本地文件夹呢,这个就比较简单了,看下面的写法就懂了:

[博客文件路径](file:///F:/博客/md)

没错就是在文件或文件夹的路径前面加上file:///就行了,注意路径为文件或文件夹的绝对路径,而且反斜杠需要转义,这个应该很好理解吧,不再解释。

这个语法的使用场景不多,毕竟每个人的文件夹路径不一样,主要使用在公司的共享文件夹中,能快速定位到目录,方便快捷。

软件推荐

好了,就介绍这三个常用的语法,其他的高阶语法使用不多,如果有需求的话,可以阅读官方文档或者看后面比较好的参考资料。现在来介绍几款非常好用且提高效率的软件。

Typora

众多 Markdown 编辑器中的清流

Typora

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

所写即所得

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

Typora 官网

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

Clover

真正好用的资源管理器插件

Clover

  • 要不要重启?!不存在的,安装即用
  • 还用鼠标?!不存在的,快捷键丰富且强大
  • Windows 资源管理器不支持标签页?!不存在的,标签+书签给你想要

用过就知道有多方便了,再也不用打开很多很多的文件夹了,唯一不太爽的是,快要推出会员机制了,唉。官网在这:

Clover 3 官网

Everything

瞬间给你想要

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

瞬搜

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

Everything 官网

参考资料

Markdown: Syntax 英文官方文档

Markdown 简明中文版

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

文章首发于 XiaRui's Zoon - 填满爬坑路上的每一个坑 ,转载请标注文章来源

 

声明:XiaRui's Zone|版权所有,违者必究|如未注明,均为原创|本网站采用BY-NC-SA协议进行授权

转载:转载请注明原文链接 - MarkDown 的常用高阶教程


在能驾驭的领域 做个自由的行者