Markdown飞行指南

Markdown飞行指南

Posted by AnAn on October 11, 2021

前言

  • 使用typora作markdown编辑器,相当不错;不过Markdown本身以语法简单出名,多掌握一种语言在工作中也会事半功倍。 下边是总结的Markdown的以下常用语法

目录

标签

  • 标题标识符为#,标题级别用#数量表示,注意#与内容之间有一个空格,语法如下:
    # 一级标题  
    ## 二级标题  
    ### 三级标题  
    #### 四级标题  
    
  • 效果如下:

    -—————————————————————-

    一级标题

    二级标题

    三级标题

    四级标题

    -—————————————————————-

段落

  • 段落的换行是使用两个以上空格加上回车
  • 在段落后面使用一个空行也可以表示重新开始一个段落

字体

  • 标题标识符为#,标题级别用#数量表示,注意#与内容之间有一个空格,语法如下:
    *斜体文本*  
    _斜体文本_  
    **粗体文本**  
    __粗体文本__  
    ***粗斜体文本***  
    ___粗斜体文本___  
    
  • 效果如下:

    -—————————————————————-
    斜体文本
    斜体文本
    粗体文本
    粗体文本
    粗斜体文本
    粗斜体文本
    -—————————————————————-

  • 公式
    • 使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现
    • 服务端需要 Mathjax渲染
  • 图例
    • 使用mermaid

列表

  • 无须列表
    • 无须列表标识符号有*,-,+显示效果没啥区别,语法如下:
      ```markdown
      • 列表1
      • 列表2
        ```
    • 效果如下:

      -—————————————————————-

      • 列表1
      • 列表2
        -—————————————————————-
    • 内容层次之间用tab分割,如下:
      ```markdown
      • 列表1
        • 列表1.1
      • 列表2
        • 列表2.2
          ```
    • 效果如下:

      -—————————————————————-

      • 列表1
        • 列表1.1
      • 列表2
        • 列表2.2
          -—————————————————————-
  • 有序列表:
    • 有序列表标识符为num.,num为阿拉伯数字,语法如下:
      ```markdown
      1. 列表1
      2. 列表1.1
      3. 列表2
      4. 列表2.1
        ```
    • 效果如下:

      -—————————————————————-

      1. 列表1
        1. 列表1.1
      2. 列表2
        1. 列表2.1
          -—————————————————————-

表格

  • 语法如下:
    |  表头   | 表头  |  
    |  ----  | ----  |  
    | 单元格  | 单元格 |  
    | 单元格  | 单元格 |  
    
  • 效果如下:

    -—————————————————————-

    表头 表头
    单元格 单元格
    单元格 单元格

    -—————————————————————-

  • 对齐方式:
    • -: 设置内容和标题栏居右对齐。
    • :- 设置内容和标题栏居左对齐。
    • :-: 设置内容和标题栏居中对齐。

超链接

  • 链接可以是页内锚点或者超链接,锚点时需要配合使用标签,语法如下:
    链接
    [链接名称](链接地址)  
    或者  
    <链接地址>  
      
    这个链接用 1 作为网址变量 [Google][1]  
    这个链接用 runoob 作为网址变量 [Runoob][runoob]  
    然后在文档的结尾为变量赋值(网址)  
    [1]: http://www.google.com/  
    [runoob]: http://www.runoob.com/  
    锚点
    <a name="标题"></a> 
    [本节标题章节的锚点](#标题) 
    
  • 效果如下:

    -—————————————————————-
    本节标题章节的锚点
    -—————————————————————-

图片

  • 标题标识符为#,标题级别用#数量表示,注意#与内容之间有一个空格,语法如下:
    ![alt 属性文本](图片地址)  
        
    ![alt 属性文本](图片地址 "可选标题")  
    
  • 效果如下:

    -—————————————————————-
    anan的图库

    anan的图库
    -—————————————————————-

代码

  • 代码区块使用 4 个空格或者一个制表符(Tab 键); 也可以用 ``` 包裹一段代码,并指定一种语言,语法如下:
        ```python  
        def say():  
          print("i am laowng") 
          ```
    
  • 效果如下:

    -—————————————————————-

    def say():  
      print("i am laowng")  
    

    -—————————————————————-

区块

  • 区块使用>作标识符号,语法如下:
    > 区块1  
    > 区块2  
    >> 区块2.1  
    >>> 区块2.1.1  
    
  • 效果如下:

    -—————————————————————-

    区块1

    区块2

    区块2.1

    区块2.1.1

    -—————————————————————-