美文网首页
MarkDown 的常用高阶教程

MarkDown 的常用高阶教程

作者: iamxiarui | 来源:发表于2018-07-02 20:49 被阅读0次

    <h2 id="1">写在前面</h2>

    接触 Markdown (以下用 MD 代替)已经有快两年,最早接触时震撼于其强大的书写格式,现在已经养成日常的文档编辑习惯。比如现在公司的代码规范、入职指南、内部平台教程与需求文档,我全部用 MarkDownPad 2 编写,然后转成 HTML 格式,阅读的人无不称赞其格式的优雅,而且更大的好处是从源头上杜绝了由于 Office 版本(甚至是想不开用 WPS )兼容问题造成的文档格式变化问题,更重要的是 HTML 可以直接存入浏览器书签,再也不用在资源管理器找来找去了。当然如果你安装了 Everything 的话,当我没说。

    话说回来,在 IT 行业,应该很少有人不知道 MD 格式的吧。MD 的基本语法大家都能熟练掌握,但是有些非常常用的进阶语法或者说小技巧不见得每个人都知道,所以现在就来说几种不仅进阶且非常常用的 MD 语法吧。以下是文章目录:

    <h2 id="2">常用高阶语法</h2>

    <h3 id="3">表格的使用</h3>

    第一个比较常用的语法就是表格,网上也有很多教程,现在就来总结一下。它的语法如下:

    |第一列|第二列|第三列|
    |:-:|:-|-:|
    |第一列是居中的|第二列是居左的|第三列是居右的|
    

    可以看出其实最重要的是|:-:|:-|-:| 这一行,如果要写表格,此行不可以省略,也就是说必须要写,但怎么写在于表格所需要的格式。

    1、列名称

    首先如果此行上面不写的话,那就没有表列名称,比如:

    |:-:|:-|-:|
    |第一列是居中的|第二列是居左的|第三列是居右的|
    
    没有列名

    简书不支持不写列名的表格,所以我截图了,可以与上面的表对比看出,现在的表没有了每一列的名称,一般来说,都是需要写的,注意,列名已经默认字体加粗了。

    2、内容位置

    细心的同学可能发现第二行中间有很多冒号,没错这就是控制表中内容是居中、居左还是居右的语法。可以把冒号看成是表的单元格的边界,而短横线相当于表单元格中的内容,比如:

    • :-: : 相当于内容被左右两个边界包裹,这就是居中
    • :- : 相当于内容靠近左边界,这就是居左
    • -: : 相当于内容靠近右边界,这就是居右

    现在看之前的表格就清楚多了吧,表格语法就是这么简单。

    3、注意事项

    • 有的教程里面把短横线画了很多,其实没有必要,只需要一个就行了,甚至居中 :-: 中的短横线都可以省略。
    • Github 上面的 README.md 中必须要写短横线,不然识别不出来。
    • 用 MarkDownPad 2 软件写表格的话,记得把处理器改成扩展,不然没有效果。
    扩展

    <h3 id="4">页内链接跳转</h3>

    啥叫页内链接跳转呢,其实就是文章开头的目录,点击章节名,可以在页内跳转。那应该如何实现呢?

    先说一下,其实 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 ,只要一一对应起来,就可以实现页内跳转了,是不是很简单呢?效果就不展示了,文章已经使用了这种方式,大家可以试一试。

    <h3 id="5">本地文件链接</h3>

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

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

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

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

    <h2 id="6">软件推荐</h2>

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

    Typora

    众多 Markdown 编辑器中的清流

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

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

    Typora 官网

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

    Everything

    瞬间给你想要

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

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

    Everything 官网

    <h2 id="7">参考资料</h2>

    Markdown: Syntax 英文官方文档

    Markdown 简明中文版

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


    个人博客:www.iamxiarui.com

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

    相关文章

      网友评论

          本文标题:MarkDown 的常用高阶教程

          本文链接:https://www.haomeiwen.com/subject/tdcruftx.html