总结自markdown官方文档
不包含数学公式、YAML、HTML等内容,太复杂了在学了在学了

布局

标题

markdown主要用两种形式表示标题:

  • 使用 = 和 - 标记一级和二级标题:

    一级标题 
    ======
    二级标题
    -------
  • 使用1~6个#标记,#与标题间应有空格

    # 一级标题
    ## 二级标题
    ### 三级标题

    段落

  • 在末尾通过两个以上空格加上回车

    段落  ↓
  • 在段落后空出一行表示重新开始一个段落

    段落1
    
    段落2

    列表

    1. 基本使用

    • 无序列表使用 * 、+ 、- 标记,标记后需一个空格。

      * 第一项
      + 第二项
      - 第三项
    • 有序列表使用数字并加上 . 号来表示。

      1. 第一项
      2. 第二项

      2. 列表嵌套
      在子列表前添加制表符tab(四个空格)。

      1. 第一项:
        	   - 第一项嵌套元素

      3. 任务表
      使用[ ]或 [x] 表示(x为字母x):

      - [ ] 未完成
      - [x] 已完成

      显示效果:

  • 未完成
  • 已完成

    引文区块

  • 在段落开头使用 > 标记区块:

    > 区块
  • 区块嵌套
    利用 > 的数量进行嵌套

    > 最外层
    >> 第一层嵌套
  • 列表中使用区块
    在 > 前添加四个空格缩进

    * 第一项
    	> 嵌套区块

    显示效果:

  • 第一项

    嵌套区块

    代码

  • 代码片段使用反括号(`)包起来
  • 代码区块使用制表符或(```)
    (tab)printf()
  • 用```时可指定语言

    ``` markdown
    *斜体*
    ```

表格

  • 使用|分割单元格,-分割表头和其他行
    | 表头 | 表头 |
    | --- | --- |
    |单元格|单元格|
    显示效果
    表头 表头
    单元格 单元格
  • 对齐方式
    • -:居右对齐
    • :-居左对齐
    • :-:居中对齐
      实例:
      | 左对齐 | 右对齐 | 居中对齐 |
      | :-----| ----: | :----: |
      | 单元格 | 单元格 | 单元格 |
      显示效果:
      左对齐 右对齐 居中对齐
      单元格 单元格 单元格

分割线

  • 在空白行输入***---可生成分割线。
  • 符号大于3个即可。

    目录

  • 输入[toc]并按下回车可创建目录。
  • 在输入处创建。

    设计

    斜体

    使用一个 *_
    *斜体文本*
    _斜体文本_

    粗体

    使用 **__
    **粗体文本**
    __粗体文本__

    粗斜体

    使用***___

    删除线

  • 使用~~包裹文本。
  • GFM增加了带有删除线文本的语法,这个功能在标准的Markdown中是没有的。

    下划线

  • 由HTML实现。
  • <u>文本</u>包裹文本即可。

    上标及下标

  • 可使用HTML语法创建。
  • 上标:使用<sup></sup>包裹文本,例O<sup>2</sup>, 即O2
  • 下标:使用<sub></sub>包裹文本,例H<sub>2</sub>,即H2

    引用

    链接

  • 行内链接:
    [链接名称](链接地址"Title")
    或
    <链接地址>
  • Title属性可省略
  • 引用链接:
    [链接名称][id]
    在文档任意处定义链接:
    [id]:链接地址 "Title"
  • 适用于被定义的链接需多次使用。

    图片

    图片的语法格式和链接非常相似,只是它们需要在链接起始的地方加一个!字符。
    ![图片备注](链接地址)
  • typora支持通过拖拽的方式把文件或者网页中的图片插入进来。点击图片之后,就能修改它的markdown源代码。如果拖拽的图片在正在编辑的文件的同一级或次一级目录中,将会使用相对路径。
  • 如果你正在使用markdown搭建网站,你需要在最开头的YAML Front Matters中加入typora-root-url属性,声明一个在你的本地电脑中预览图片的URL前缀。比如,在YAML Front Matters中输入typora-root-url:/User/Abner/Website/typora.io/,那么![alt](/blog/img/test.png)在Typora中就会被识别为![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)

    Tips

    转义

    markdown支持以下符号前加上 \ 以显示普通字符:
    字符
    \ 反斜线
    ` 反引号
    * 星号
    _ 下划线
    {} 花括号
    [] 方括号
    () 小括号
    # 井字号
    + 加号
    - 减号
    . 英文句点
    ! 感叹号

血泪教训

  • 建议尽量使用+建立列表以与粗体、斜体避免歧义 。
  • 表格一定要加表头。

本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!

markdown进阶语法 上一篇
Hello World! 下一篇