Markdown 语法

段落与换行

  1. 段落的前后必须是空行:
    空行指的是行内什么都没有,或者只有空白符(空格或制表符)
    相邻两行文本,中间没有空行 会显示在一行
  2. 如果需要在段落内加入换行:
    可以在前一行的末尾加入至少两个空格
    然后换行写其他的文字
  3. Markdown 中的多数区块都需要在两个空行之间

标题

H1
====
H2
----
# H1
## H2
### H3
#### H4 ####
##### H5

引用

引用内容

>引用内容

引用内容

多行引用

>多行引用
>可以在每行前加`>`

多行引用 可以在每行前加>

>如果仅在第一行使用`>`
后面相邻的行即使省略`>`,也会变成引用内容

如果仅在第一行使用> 后面相邻的行即使省略>,也会变成引用内容

>如果引用内容需要换行,  
>可以在行尾添加两个空格
>
>或者在引用内容中加一个空行

如果引用内容需要换行,
可以在行尾添加两个空格

或者在引用内容中加一个空行

嵌套引用

>也可以在引用中
>>使用嵌套的引用

也可以在引用中

使用嵌套的引用

其他markdown

>在引用中可以使用其他任何 *Markdown* 语法

在引用中可以使用其他任何 Markdown 语法

列表

无序列表

* 可以使用`*` 作为标记
+ 也可以使用`+`
- 或者`-`
  • 可以使用* 作为标记
  • 也可以使用+
  • 或者-

有序列表

有序列表以数字和.加一个空格开始

嵌套的列表

1. 第一层
+ 1-1
+ 1-2
2. 无序列表和有序列表可以随意相互嵌套
	2. 2-1
	3. 2-2
  1. 第一层
    • 1-1
    • 1-2
  2. 无序列表和有序列表可以随意相互嵌套
    1. 2-1
    2. 2-2

代码

代码块

可以使用缩进来插入代码块

<html> // Tab开头
	<title> Markdown </title>
</html> // 四个空格开头

行内代码

`<title>markdown</title>`

可以通过` `,插入行内代码,如 <title>markdown</title>

转换规则

代码中的文本(包括markdown语法)都会显示为原始内容,而特殊字符被转化为HTML字符实体。

分隔线

可以在一行中使用三个或更多的*-_ 来添加分隔线
***
---
___




多个字符之间可以有空格
* * *
- - -
_ _ _




超链接

行内式

  • 格式为:
    [link text](URL 'title text')
  • 普通链接:
    [Google](https://www.google.com/)
    Google
  • 指向本地文件的链接:
    [icon.png](./images/icon.png)
    icon.png
  • 包含title的链接:
    [google](https://www.google.com/ "Google")
    google

参考式

  • 首先定义链接
    [Google][link]
    Google
  • 然后定义链接内容
    [link]: https://www.google.com "Google"
    格式为: [识别符]: URL “title”
  • 也可以省略识别符, 使用链接文本作为识别符:
    [google][]
    [google]: http://www.google.com/ "Google"
    google

图像

行内式

![GitHub](https://avatars2.githubusercontent.com/u/3265208?v=3&s=100 "GitHub,Social Coding") GitHub

参考式

![GitHub][github]
[github]: https://avatars2.githubusercontent.com/u/3265208?v=3&s=100 "GitHub,Social Coding" GitHub

指定图片大小

<img src="https://avatars2.githubusercontent.com/u/3265208?v=3&s=100" alt="GitHub" title="GitHub,Social Coding" width="50" height="50" /> GitHub

强调

这是用来 *演示*_文本_
这是用来 **演示**__文本__
这是用来 * 演示*_文本 _
这是用来 \*演示\*\_文本\_

这是用来 演示文本
这是用来 演示文本
这是用来 * 演示* 的 _文本 _
这是用来 *演示* 的 _文本_

字符转义

\
`
*
_
{}
[]
()
#
+
-
.
!

扩展语法

删除线

这是~~删除线~~
这是删除线

代码块和语法高亮

代码块

```
<p>code here</p>
```
<p>code here</p>

语法高亮

```js
window.addEventListener('load', function(){
console.log('window loaded');
});
```
window.addEventListener('load', function(){
	console.log('window loaded');
});

表格

单元格和表头

使用|来分隔不同的单元格, 使用-来分隔表头和其他行

name | age
---- | ----  
learnShare | 12
Mike | 32
name age
learnShare 12
Mike 32

为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用|来标记单元格边界

|     name     | age |
| ------------ | --- |  
|  LearnShare  |  12 |  
|  Mike        |  32 |  
name age
LearnShare 12
Mike 32

对齐

  • :— 代表左对齐
  • :–: 代表中对齐
  • —: 代表右对齐
| left | center | right |  
| :--- | :----: | ----: |  
| aaaa | bbbbbb | ccccc |  
| a    | b      | c     |
left center right
aaaa bbbbbb ccccc
a b c

如果不是用对齐标记,单元格中的内容默认左对齐,表头单元格中的内容会一直居中对齐

插入其他内容

表格中可以插入其他Markdown中的行内标记:

|    name      | age |        blog                        |
| ------------ | --- | ---------------------------        |  
| _LearnShare_ |  12 | [LearnShare](http://www.baidu.com) |  
| __Mike__     |  32 | [Mike](http://www.baidu.com)       |
name age blog
LearnShare 12 LearnShare
Mike 32 Mike

Task List

- [ ] Eat
- [x] Code
	- [x] HTML
	- [x] CSS
	- [x] JavaScript
- [ ] Sleep
  • Eat
  • Code
    • HTML
    • CSS
    • JavaScript
  • Sleep