# Markdown

# 参考文档

# 基本语法

# 标题

  • # H1
  • ## H2
  • ### H3
  • #### H4
  • ##### H5
  • ###### H6
  • === 一级标题
  • --- 二级标题

# 斜体

  • 使用一个 * 将要格式化的字体包起来。

# 加粗

  • 使用两个 ** 将要格式化的字体包起来。

# 加粗倾斜

  • 三个 * 号包起来,前后各三个 * 号。

# 删除线

  • 前后各两个 ~~

# 分割线

  • 使用四个中划线 ----,并且使用分割线之前必须有一行空行。

# 引用

  • 使用 >text 的格式进行引用,并且在引用之前必须有一行是空行。

# 列表

  • 列表使用前必须要加空格
  • 无序列表
    • 使用 -、+、*加上文字 text 的格式
  • 有序列表
    • 使用 num.text 的格式

# 表格

  • 表格前必须空一行
  • 单元格使用 | 进行分割,表头的分割符使用 - 进行分割。
    • -:- 表示表头和单元格左对齐
    • -: 表示右对齐
    • :-: 表示居中对齐。

# 代码块

  • 行内代码,使用前后一个 ` 符号包裹起来,注意这里不是单引号是,是反斜号。
  • 多行代码,使用前后三个 ``` 符号包裹起来。并可以指定一种编程语言进行高亮显示。
    • 例如

      ```js

      你好

      ```

# 转义字符

  • 使用反斜杠,\ 进行特殊字符的转义。

# 链接

# 图片

  • ![title](URL)
    • title 指的是图片的替代文字
    • URL 是图片的地址

# 注意事项

# 空格

  • 中英文之间需要增加空格。
  • 中文与数字之间需要增加空格。
  • 数字与单位之间无需增加空格。
  • 全角标点与其他字符之间不加空格。
    • 例外:裸链接后面需空格,不能紧跟标点,否则有些渲染器会把标点当成链接的一部分。
  • 中文与链接、强调、行内代码等格式间是否加空格取决于内容(即以上规则)。
    • 比如书写 Markdown 的规范需要加,而书写中文的规范不需要加。

# 怎么写 Markdown

  • 文件名全部用英文,camelCase。
  • 图片放到文档所在目录的 images/ 子目录内,使用相对路径引用,比如 ![demo](./images/demo.png)
  • FAQ 子标题应使用疑问句,问号结尾。
  • 引用人名一律用 @xxx.xxx 的形式。

# 讨论区

由于评论过多会影响页面最下方的导航,故将评论区做默认折叠处理。

点击查看评论区内容,渴望您的宝贵建议~
Last Updated: 6/10/2022, 3:54:48 PM