Jarod's Blog

0%

Markdown 简明语法手册

发表于 更新于 分类于
本文字数： 2.5k 阅读时长 ≈ 2 分钟

  1. 初次接触Markdown，很多地方需要熟悉一下，转来这篇小教程，算是练练手，也为以后使用留个参考。Markdown

    Cmd Markdown 简明语法手册

    1. 斜体和粗体

    使用 * 或 ** 包裹文字表示斜体和粗体。

    示例：

    这是 *斜体*，这是 **粗体**。

    表现：

    这是 _斜体_，这是 粗体。

    2. 分级标题

    使用 === 表示一级标题，使用 — 表示二级标题。 你也可以选择在行首加井号表示不同级别的标题 (H1-H6)，例如：# H1, ## H2, ### H3，#### H4。

    示例：

    这是一个一级标题 ============================

    这是一个二级标题 ————————————————–

    ### 这是一个三级标题

    表现：

    这是一个一级标题

    这是一个二级标题

    这是一个三级标题

    3. 外链接

    使用 [描述](链接地址) 的形式为文字增加外链接。

    示例：

    这是去往 [本人博客](https://www.offodd.com) 的链接。

    表现：

    这是去往 本人博客 的链接。

    4. 无序列表

    行首使用 * 或 + 或 - 开头表示无序列表。 行首使用 空格 缩进可添加二级列表

    示例：

    * 无序列表项一 ﹏* 表项1(此行左侧有一个不可见的空格) + 无序列表项二 ﹏+ 表项2(此行左侧有一个不可见的空格) - 无序列表项三 ﹏- 表项3(此行左侧有一个不可见的空格)

    表现：

    • 无序列表项一
      • 表项1(此行左侧有一个不可见的空格)
    • 无序列表项二
      • 表项2(此行左侧有一个不可见的空格)
    • 无序列表项三
      • 表项3(此行左侧有一个不可见的空格)

    5. 有序列表

    行首使用 数字和点 开头表示有序列表。

    示例：

    1. 有序列表项一 2. 有序列表项二 3. 有序列表项三

    表现：

    1. 有序列表项一
    2. 有序列表项二
    3. 有序列表项三

    6. 文字引用

    行首使用 > 表示文字引用，使用多个 >> 可多级嵌套引用。

    示例：

    > 离离原上草，一岁一枯荣。 >> 野火烧不尽，春风吹又生。

    表现：

    离离原上草，一岁一枯荣。

    野火烧不尽，春风吹又生。

    7. 行内代码块

    使用 `代码` 表示行内代码。

    示例：

    让我们聊聊 `html`。

    表现：

    让我们聊聊 html。

    8. 代码块

    行首使用 四个缩进空格 或 一个制表符（Tab） 开头表示代码块。 或在代码块前后一行使用 ``` 包裹代码块。

    示例：

    ﹏﹏﹏﹏这是一个代码块    //此行左侧有四个不可见的空格。

    ``` 这也是一个代码块 ```

    表现：

    1
    这是一个代码块    //此行左侧有四个不可见的空格。
    1
    这也是一个代码块

    9. 插入图像

    使用 ![描述](图片链接地址) 的形式插入图像。

    示例：

    ![我的Logo](https://www.offodd.com/logo.png)

    表现：

    我的Logo

    10. 删除线

    使用 ~~ 表示删除线。

    示例：

    这是一段错误的文本。

    表现：

    这是一段错误的文本。

    11. 分割线

    分割线最常使用就是三个或三个以上的 - 或 *

    示例：

    -——-

    ********

    表现：

    Cmd Markdown 高阶语法手册

    1. 注脚

    使用 [^keyword] 表示注脚，然后使用 [^keyword]: 表示注脚的解释。

    示例：

    这是一个注脚[^footnote]的样例。(注脚解释在页脚)

    这是第二个注脚[^footnote2]的样例。(注脚解释在页脚)

    [^footnote]: 这是一个 *注脚* 的 **解释文本**。

    [^footnote2]: 这是另一个 *注脚* 的 **解释文本**。

    表现：

    这是一个注脚1的样例。(注脚解释在页脚)

    这是第二个注脚2的样例。(注脚解释在页脚)

    2. 表格支持

    用 表示表格纵向边界，表头和表体用 - 隔开；用 : 进行对齐设置，在左边则表示左对齐，在右边则表示右对齐，两边都有:则表示居中，若不加 : 则默认左对齐。

    • -—:为右对齐
    • :—-为左对齐
    • :—:为居中对齐
    • -—-为默认左对齐

    示例：

    1
    2
    3
    4
    5
    项目         价格     数量  
    --------    -----:   :----:  
    计算机      \$1600    5     
    手机           \$12      12   
    管线            \$1      234

    表现：

    项目

    价格

    数量

    计算机

    $1600

    5

    手机

    $12

    12

    管线

    $1

    234

    3. Html 标签

    支持在 Markdown 语法中嵌套 Html 标签，譬如，你可以用 Html 写一个纵跨两行的表格：

    示例：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    <table>
        <tr>
            <th rowspan="2">值班人员</th>
            <th>星期一</th>
            <th>星期二</th>
            <th>星期三</th>
        </tr>
        <tr>
            <td>李强</td>
            <td>张明</td>
            <td>王平</td>
        </tr>
    </table>
    <table>
        <tr>
            <th rowspan="2">值班人员</th>
            <th>星期一</th>
            <th>星期二</th>
            <th>星期三</th>
        </tr>
        <tr>
            <td>李强</td>
            <td>张明</td>
            <td>王平</td>
        </tr>
    </table>

    表现：

    值班人员

    星期一

    星期二

    星期三

    李强

    张明

    王平

    值班人员

    星期一

    星期二

    星期三

    李强

    张明

    王平

    本文参考

    作业部落：https://www.zybuluo.com/mdeditor Markdown的基本语法：https://www.jianshu.com/p/250e36bb5690

    1. 这是一个 注脚 的 解释文本。 ↩
    2. 这是另一个 注脚 的 解释文本。 ↩