MarkDown语法
以纯文本形式原样发布
虽然编辑时会使用语法,但是展示时不会包含标记标签、格式化指令以及标点符号组成的语法
HTML元素
1.MD未包含的标签,可以直接使用HTML标签;
2.MD包含的标签,需要使用
定界符
或标识符
表明从MD切换到HTML3.对于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("这是代码块")
}
列表
无序列表
使用
*
+
-
等等符号
- 无序列表是这样
有序列表
使用数字加句号
- 有序列表是这样
- 如果数字加句号无意触发有序列表,需要转义 1919.
列表项中每个段落都必须用 4个空格或一个水平制表符来缩进
列表项中包含块注释,标记
>
需要缩进列表项中有代码块,代码块需要双倍缩进 8个空格或2个水平制表符
代码块
MD的语法在代码块中是无效的
水平线
一行中只有 三个以上的
-
或*
或_
会生成一条水平线
链接
内联
[
这是链接文本]
(
这是地址 "可选引号放置链接标题")
this is 百度
引用
1. 引用同服务器的本地资源
this is
[
链接文本]
(
这是相对路径)
- 定义链接标签,再引用链接
1. this is `[` 链接文本 `]` `[` 链接id`]` 2. [链接id] 链接地址 链接标题
强调
用
*
或者_
包裹 相当于<em>标签这是用星号包裹
这是用下划线包裹
用双
*
或者_
包裹 相当于<strong>标签这是双星号包裹
这是双下划线包裹
如果要使用
_
或者*
的字面量,需要用 \转义
- this text is surrounded by literal asterrisks *
代码
对代码片段标识,使用重音符号 `
Use the
print()
function重音符号作为字面量,需要多个重音符号进行包裹
图片
内联
!
[
Alt 属性]
(
路径 "名称,可选")
引用
!
[
Alt 属性]
(
路径id)
[路径id] url/to/image "名称"
自动链接
<
链接地址>
反斜杠转义
下面字符要使用字面量 通过反斜杠转义
\ backslash
` backtick
* asterisk
_ underscore
{} curly braces
[] square brackets
() parentheses
# hash mark
+ plus sign
- minus sign
. dot
! exclamation mark