字体
标题
- 在每行下面使用底线(
-
/=
),使用==
为一级标题,--
为二级标题,底线的数量至少两个。这种标记法只支持两级标题。 - 在行前面使用#,多少个#就代表几级标题,最多6级。
粗体和斜体
- 粗体由两个
*
或_
包裹表示。 - 斜体由一个
*
或_
包裹表示。 - 建议使用
*
,语法内部不要有空格。
段落与换行
列表
- 有序列表:用数字+英文句号
.
+空格+列表内容。- 我有一个梦想
- 我有一个梦想
*
+
或-
+空格+列表内容。- 我有一个梦想
- 我有一个梦想
- 使用
*
+
-
标记无序列表的效果是一样的。 - 嵌套列表使用
tab
键,有序和无序也可以相互嵌套。 - 建议使用
-
来表示无序列表,*
容易和粗体斜体弄混,+
不推荐。
分割线
由三个及以上的*
-
或_
来标记。
***
---
_ _ _
三者效果一样,如下
行内不能有其他字符,但可以有空格。
图片
语法为
- 图片替代文字可以为空(但是需要有中括号),图片无法显示的时候才有用。
- 图片地址可以是本地图片或网络图片。
- 本地支持绝对路径和相对路径。
链接
文字链接
语法为
相当于超链接,但是这种写法可读性比较差。例如[百度](https://baidu.com)
引用链接
先把链接在某个地方统一定义好,然后再在正文中通过“变量”来引用。
例:在日常生活中我们常用的网址有[百度][baidu]
、[github][github]
等。
[baidu]: http://baidu.com "百度"
[github]: https://github.com (git)
- 链接标记可以含有数字、字母、空格和标点符号。
- 链接标记不区分大小写。
- 链接内容可以放到文章任意位置,但是前一行需要和其他行用空行分隔。
- 网络地址要以http(s)开头,否则会被误认为是本地地址。
扩充内容:
- 隐式链接,省略链接标记的内容,直接用一个空的中括号,用链接文字作为标识符。例:[baidu][]
- 可以给链接加一个标题(链接说明),用
"
或'
或()
包裹,这样在将鼠标悬停到链接文字上时会显示标题信息。
网址链接
用<>将网络地址或邮箱地址包裹起来会自动将其转化为超链接。
例如<https://baidu.com> <2629516309@qq.com>
但是大多markdown扩展语法都支持自动链接,不需要<>
也可以自动将网址转化为超链接
行内代码与代码块
行内代码使用`包裹,print("hello, Markdown")
,``也可以用于表示强调或转义。例如*
代码块以四个空格或Tab开头
但是不够直观,扩展语法GFM可以使用围栏代码块等
def print_name():
pass
引用
>
+引用内容
1. 多行引用可以在每行都加>
。
2. 可以嵌套引用。
3. 引用中可以使用其他Markdown语法。
4. 段落与换行的格式在引用中也是适用的。
美到处都是有的
缺少的是一双发现美的眼睛。
http://baidu.com
转义
在特殊符号前加入反斜杠,可以被转义的符号有: