Markdown语法进阶

常用语法总结

原样输出 页内跳转 代码高亮 注释 表格 生成目录 脚注尾注 流程图 饼图 数学公式


Markdown 是什么?

Markdown 是一种轻量级标记语言,创始人是约翰・格鲁伯(John Gruber)。它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML 文档”。

—— 维基百科。

常用语法总结


原样输出

1.使用反斜杠\ 如 \斜体


页内跳转

<a id="table1">Table - 1</a>    #要跳转的位置,id = 链接位置
[跳转到 Table-1](#table1)        #在需要跳转的地方引用,点击即可实现跳转(编辑器中右键打开链接)

代码高亮

代码块后面标注语法类型,即可完成语法的高亮显示。

echo 'hello';

注释

第一是通过 html 的 <!– –> 标记;

第二可以通过样式隐藏段落内容,即 <div style=“display:none”>;第三是通过 Markdown 自身的解析原理实现。

表格

表格包含三个部分:表头、分割线、数据。

表头 用来对列名对象进行描述,也就是通常所说的列名;

数据 用来展示每行的具体内容,数据是表格的核心;

分割线 用来区分表头和数据,也是 Markdown 中表格定义的最基本语法要求。

竖线 用来定义列,每两个竖线之间为一个单元格元素;

减号 用来定义分割线,也就是分割表头和数据体;

冒号 配合减号使用,用于定义列数据的对齐属性。

在分割线上使用 「冒号 :」可以定义列内容的对齐方式。

定义表格

#### 表格内容的对齐

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 1      |   张三   |   17岁 |
| 2      |   李四   |   18岁 |
| 3      |   王五   |   19岁 |

生成目录

自动生成目录非常简单,只需要在恰当的位置添加 [TOC] 符号,凡是以 # 定义的标题都会被编排到目录中。

[TOC]

# 一级标题

一些内容。。。。

## 二级标题

一些内容。。。。

### 三级标题

一些内容。。。。

脚注尾注

要增加脚注(尾注),首先需要在文章的适当位置增加引用的描述,形如:[^引用ID]: 说明文字。

《出师表》(节选)

先帝[^注释1]创业[^注释2]未半而中道[^注释3]崩殂[^注释4],今[^注释5]天下三分[^注释6],益州疲弊[^注释7],此[^注释8]诚危急存亡之秋也。然[^注释9]侍卫之臣不懈于内,忠志之士忘身[^注释10]于外者,盖追先帝之殊遇[^注释11],欲报之于陛下也。诚[^注释12]宜开张圣听[^注释13],以光[^注释14]先帝遗德,恢弘[^注释15]志士之气,不宜妄自菲薄[^注释16],引喻失义[^注释17],以塞忠谏之路也[^注释18]。

[^注释1]: 先帝:指汉昭烈帝刘备。先,尊称死去的人。
[^注释2]: 创:开创,创立;业:统一天下的大业。
[^注释3]: 中道:中途。
[^注释4]: 崩殂(cú):死。崩,古时指皇帝死亡。殂,死亡。
[^注释5]: 今:现在。
[^注释6]: 三分:天下分为孙权,曹操,刘备三大势力。
[^注释7]: 益州疲弊:弱,处境艰难;益州:汉代行政区域十三刺史部之一,包括今四川省和陕西省一带,这里指蜀汉。疲弊(pí bì):人力缺乏,物力缺无,民生凋敝。
[^注释8]: 此:这;诚:的确,实在;之:的;秋:时,时候,这里指关键时期,一般多指不好的。
[^注释9]: 然:然而;侍:侍奉;卫:护卫;懈:松懈,懈怠;于:在;内:皇宫中。
[^注释10]: 忘身:舍身忘死,奋不顾身。
[^注释11]: 盖:原来;追:追念;殊遇:优待,厚遇。
[^注释12]: 诚:的确,确实;宜:应该。
[^注释13]: 开张圣听:扩大圣明的听闻,意思是要后主广泛地听取别人的意见;开张,扩大。
[^注释14]: 光:发扬光大,用作动词;遗德:留下的美德。
[^注释15]: 恢弘:发扬扩大,用作动词。恢,大。弘,大,宽,这里是动词,也做“恢宏”;气:志气。
[^注释16]: 妄自菲薄:过于看轻自己;妄:过分;菲薄:小看,轻视。
[^注释17]: 引喻失义:讲话不恰当。引喻:称引、譬喻;喻:比如;义:适宜、恰当。
[^注释18]: 以:以致(与以伤先帝之明的以用法相同:以致);塞:阻塞;谏:劝谏。

折叠语法

普通折叠

<details> 
    <summary>指示标题</summary>
    内容
</details>

代码块的折叠

<details> 
    <summary>展开查看</summary>
    <pre><code>
        此处为代码的块具体内容
    </code></pre> 
</details>

未完待续 …