1. 标题
#
号表示标题。#
(h1
) 到 ######
(h6
),总共六级标题,在井号后需要加一个空格。
# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6
2. 段落和换行
- 段落前后要有一个以上的空行。普通段落不要用空格和
tab
符缩进。 - 或者使用 两个空格加回车 产生
<br />
标签。
3. 区块引用
- 区块引用会转换为
<blockquote>
标签。 - 在每行最前面加上
>
;或只在整个段落的第一行最前面加上>
。 - 区块引用可以嵌套,只要根据层次加上不同数量的
>
。 - 引用的区块内也可以使用其他的 Markdown 语法。
4. 列表
无序列表
使用 *
星号、+
加号、或 -
减号作为标记,标记与文字之间至少要有一个空格。即 <ul>
标签。
- 星号:* 星号
- 加号:+ 加号
- 减号:- 减号
有序列表
使用数字加一个英文句点,标记与文字之间至少要有一个空格。即 <ol>
标签。
- 有
- 序
- 列
- 表
制作待办事项 Todo List
- [ ] 用
- [ ]
来表示未办事项,短横与中括号之间有空格,中括号之间与之后有空格。 - [x] 用
- [x]
来表示已办事项,短横与中括号之间有空格,中括号之后有空格。
5. 代码
代码区块
转换为 <pre>
和 <code>
标签。
缩进 4 个空格
<div>
<p>这是一段代码</p>
</div>
或者上下用用三个反引号 ``` 引起来,并且在上面的三个反引号后面可添加代码的语言。
console.log('js');
行内代码
如果要标记一小段行内代码,可以用反引号 `
包起来。比如 <code>行内代码</code>
。
6. 分隔线
可以在一行中用三个以上的 * * *
星号、---
减号、___
下划线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。即 <hr>
标签。
7. 强调
使用 *
或下划线 _
来标记。符号与文字之间不能有空格。
-
斜体:用一个符号包围的文字为
*斜体*
,转换为<em>
标签。 -
粗体:用两个符号包围的为
**粗体**
,转换为<strong>
标签。
8. 链接
行内式
链接文字用 []
方括号来标记。方括号之后紧接着圆括号 ()
插入网址即可。如果想在链接上加 title
,只要在网址后面空个空格,然后用双引号把 title
文字包起来就可以。会转换为 <a>
标签。
[markdown 语法](http://www.markdown.cn/ "markdown 教程")
<!-- 相当于 -->
<p>
<a href="http://www.markdown.cn/" title="markdown 教程">markdown 语法</a>
</p>
自动链接
用 <>
尖括号包起来。一般网址的链接文字就和链接地址一样。<http://www.baidu.com>
。
图片
- 一个惊叹号
!
- 接着一个
[]
方括号,里面放上图片的替代文字 - 接着一个
()
普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的title
文字。
![Alt text](/path/to/img.jpg "Optional title")
Markdown 还没有办法指定图片的宽高,如果需要的话,可以使用普通的 <img>
标签。
反斜杠
一些特殊的符号,要当成普通符号来用的话,可在前面加上 \
反斜杠。
表格
ID | name | age |
---|---|---|
1 | dora | 18 |
|ID|name|age|
|:--|:-:|-:|
|1|dora|18|
-
|
、-
、:
之间的多余空格会被忽略,不影响布局。 -
-:
表示内容和标题栏居右对齐,:-
表示内容和标题栏居左对齐,:-:
表示内容和标题栏居中对齐。 - 内容和
|
之间的多余空格会被忽略,每行第一个|
和最后一个|可以省略,-
的数量至少有一个。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。