# Markdown

:一种对文本进行简单排版的标记语言,可以被 Markdown 编辑器识别并渲染成美观的 HTML 页面。

# 语法

  • Markdown 格式的文本文件的扩展名为 .md 。

  • Markdown 兼容 HTML 的语法,比如插入 <p> 标记。

  • 换行

    • 在 Markdown 文档中输入连续多个空格时,只会显示一个空格。
    • 在 Markdown 文档中输入连续多个空行时,只会显示一个空行。
    • 在行尾加上一个 \ ,可以在显示时强制换行。
  • 标题

    • 一行以井号 + 空格开头,会显示成标题,采用大写、粗体字体。
    • 行首井号的数量从 1 到 6 ,对应一级标题到六级标题,字号依次递减。
    • 例:
      # 一级标题
      ## 二级标题
      ### 三级标题
      
  • 字体:

    • 在字符串前后加上连续 n 个星号 * 或下划线 _ ,会显示成特殊字体。
    • 例:
      普通字体
      *斜体*  _斜体_
      **粗体**  __粗体__
      ***斜粗体***  ___斜粗体___
      ~~删除线~~
      
  • 无序列表

    • 连续多行以 * - + 三者之一的符号 + 空格开头,会显示成无序列表。
    • 行首可以加上空格缩进,从而显示出多个层级。
    • 例:
      * sentence
      * sentence
        - sentence
        - sentence
          + sentence
          + sentence
      
  • 有序列表

    • 连续多行以阿拉伯数字 + 小数点 + 空格开头,会显示成无序列表。
    • 例:
      1. sentence
      2. sentence
      3. sentence
      
  • 表格

    • :连续多行,每列字段用 | 作为分隔符。第一行是表头。第二行的每列内容为 - ,用于确定整个表格的总列数。
      key | Value
      -   | -
      a   | 1
      b   | 2
      c   | 3
      
  • 引用

    • 一行以大于号 > 开头,会显示成单行引用。
    • 段首以四个以上的空格开头时,会显示成一个缩进的区块。
  • 代码

    • 在字符串前后加上反引号 ` 作为定界符,会加亮显示。如下:
      请在终端输入命令 `ls -l`
      
    • 在文本前后加上三个反引号 ``` ,会显示成代码块。还可在开头加上编程语言的名称,让代码块根据语法高亮显示多种颜色。如下:
      print('hello')
      
  • 链接

    • 有多种格式:
      <https://www.baidu.com>
      [一个超链接](https://www.baidu.com)
      ![一张图片](1.png)
      ![一张图片,居中显示且限制尺寸](1.png#pic_center =60x60)
      
  • 如果要显示 Markdown 语法中的保留字符,则需要用反斜杠转义,如下:

    \<  \*  \#
    

    显示反引号时,要用两个反引号作为定界符:

    `` Hi` ``
    
  • 还有一些扩展语法,MarkDown 阅读器不一定支持:

    [TOC]         <!-- 显示目录,这会收集当前文档的各个标题 -->
    x^2^          <!-- 上标 -->
    H~2~O         <!-- 下标 -->
    ==Notice==    <!-- 高亮显示 -->
    ---           <!-- 显示一行水平分割线 -->