MarkDown语法

以纯文本形式原样发布

虽然编辑时会使用语法，但是展示时不会包含标记标签、格式化指令以及标点符号组成的语法

HTML元素

1.MD未包含的标签，可以直接使用HTML标签；

2.MD包含的标签，需要使用定界符 或 标识符 表明从MD切换到HTML

3.对于HTML块级元素，像<div><table><pre><p>等必须另起一行单独放置，且开合标签前不能缩进

4.MD语法在HTML块级元素中不会被处理

5.HTML内联元素<span><cite><del>等可以在MD段落、列表项、标题中任意使用

6.MD语法可以在内联元素中解析

特殊字符自动转义

HTML中

< 用于起始标签,字面量表示<用 <

& 用于表示HTML字符实体,字面量表示&用&

MD中

可以自由使用<与&，生成HTML时会自动被转义

而使用 < 会转义<,使用 &会转义成&

段落与换行

段落：一个或多个空行之间 划分出来的连续文本

标题

# 后接空格 再接内容就是标题，1-6个# 分别对应1-6级标题

块引用 >

块引用中可以包括标题、列表和代码块

块引用可以嵌套 > >

块引用可以包含标题

这是二级标题

块引用可以包含列表

• 这是列表1

• 这是列表2

• 这是列表3

块引用可以包含代码块

public static void main(String [] args){

System.out.println("这是代码块")

}

列表

无序列表

使用 * + - 等等符号

• 无序列表是这样

有序列表

使用数字加句号

1. 有序列表是这样

2. 如果数字加句号无意触发有序列表，需要转义 1919.

列表项中每个段落都必须用 4个空格或一个水平制表符来缩进

列表项中包含块注释，标记 > 需要缩进

列表项中有代码块，代码块需要双倍缩进 8个空格或2个水平制表符

代码块

MD的语法在代码块中是无效的

水平线

一行中只有 三个以上的 - 或 * 或 _ 会生成一条水平线

---

---

---

链接

内联 [ 这是链接文本 ] ( 这是地址 "可选引号放置链接标题" )

this is 百度

引用

1. 引用同服务器的本地资源

this is [ 链接文本 ] ( 这是相对路径 )

2. 定义链接标签，再引用链接

1.  this is `[` 链接文本 `]`  `[` 链接id`]`
    
    
2.  [链接id]  链接地址 链接标题

强调

用 * 或者 _ 包裹 相当于<em>标签

这是用星号包裹

这是用下划线包裹

用双 * 或者 _ 包裹 相当于<strong>标签

这是双星号包裹

这是双下划线包裹

如果要使用 _ 或者 * 的字面量，需要用 \转义

• this text is surrounded by literal asterrisks *

代码

对代码片段标识，使用重音符号 `

Use the print() function

重音符号作为字面量，需要多个重音符号进行包裹

图片

内联

! [ Alt 属性] ( 路径 "名称，可选")

Alt text

引用

! [ Alt 属性] ( 路径id)

[路径id] url/to/image "名称"

自动链接

< 链接地址>

http://www.baidu.com

反斜杠转义

下面字符要使用字面量 通过反斜杠转义

\ backslash

` backtick

* asterisk

_ underscore

{} curly braces

[] square brackets

() parentheses

# hash mark

+ plus sign

- minus sign

. dot

! exclamation mark