0%

Markdown语法

基本技巧

标题

1
2
3
4
5
6
7
8
9
10
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
标题1
======
标题2
------

粗斜体

1
2
3
*斜体文本*    _斜体文本_
**粗体文本** __粗体文本__
***粗斜体文本*** ___粗斜体文本___

链接

1
2
文字链接[链接名称](http://链接网址)
网址链接

高级链接技巧

1
2
3
4
5
6
链接 1 作为网址变量 [Google][1].
链接 yahoo 作为网址变量 [Yahoo!][yahoo].
然后在文档的结尾为变量赋值(网址)

[1]\: http://www.google.com/
[yahoo]\: http://www.yahoo.com/

列表 - 普通 - 无序 - 列表

1
2
3
\- 列表文本前使用 [减号+空格]
\+ 列表文本前使用 [加号+空格]
\* 列表文本前使用 [星号+空格]
  • 普通
  • 有序
  • 列表
  1. 列表前使用 [数字+空格]
  2. 我们会自动帮你添加数字
  3. 不用担心数字不对,显示的时候我们会自动把这行的 7 纠正为 3

列表嵌套

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1. 列出所有元素:
- 无序列表元素 A
1. 元素 A 的有序子列表
- 前面加四个空格
2. 列表里的多段换行:
前面必须加四个空格,
这样换行,整体的格式不会乱
3. 列表里引用:

> 前面空一行
> 仍然需要在 > 前面加四个空格

4. 列表里代码段:


1
前面四个空格,之后按代码语法 ``` 书写


或者直接空八个,引入代码块

引用 > 普通引用

1
2
3
4
5
6
7
8
9
10
> 引用文本前使用 [大于号+空格]
> 折行可以不加,新起一行都要加上哦
> 引用里 > > 嵌套引用
> 最外层引用
> > 多一个 > 嵌套一层引用
> > > 可以嵌套很多层
> - 引用里嵌套列表
> - 这是引用里嵌套的一个列表
> - 还可以有子列表
> * 子列表需要从 - 之后延后四个空格开始

图片

跟链接的方法区别在于前面加了个感叹号 !,这样是不是觉得好记多了呢?

1
![图片名称](http://图片网址)

当然,你也可以像网址那样对图片网址使用变量

链接 1 作为网址变量 [Google][1]. 然后在文档的结尾位变量赋值(网址)

也可以使用 HTML 的图片语法来自定义图片的宽高大小

1
2
3
<code>
`<image src="http://7xt737.com1.z0.clouddn.com/blog_image14384920.jpg" width="100">`
</code>

换行

如果另起一行,只需在当前行结尾加 2 个空格

1
2
3
在当前行的结尾加 2 个空格  
这行就会新起一行
如果是要起一个新段落,只需要空出一行即可。

分隔符

如果你有写分割线的习惯,可以新起一行输入三个减号-。当前后都有段落时,请空出一行:

1
2
3
4
5
6
7
<pre>
前面的段落

---

后面的段落
</pre>

高级技巧

行内 HTML 元素

目前只支持部分段内 HTML 元素效果,包括
<kdb> <b> <i> <em> <sup> <sub> <br>

键位显示

使用

<kbd>Ctrl<kbd>+<kbd>Alt<kbd>+<kbd>Del<kbd> shi重启电脑

代码块

使用 (`
`) 元素同样可以形成代码块

粗斜体

<b> Markdown 在此处同样适用,如 <b>加粗<b> == 加粗

符号转义

如果你的描述中需要用到 markdown 的符号,比如 _ # * 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 \_ \# \* 进行避免。

_不想这里的文本变斜体_

**不想这里的文本被加粗**

扩展

支持 jsfiddle、gist、runjs、优酷视频,直接填写 url,在其之后会自动添加预览点击会展开相关内容。

1
2
3
4
http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/
https://gist.github.com/{gist_id}
http://runjs.cn/detail/{id}
http://v.youku.com/v_show/id_{video_id}.html

公式

当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:

``
$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $$

$$ x \href{why-equal.html}{=} y^2 + 1 $$
``

同时也支持 HTML 属性,如:

``
$$ (x+1)^2 = \class{hidden}{(x+1)(x+1)} $$

$$ `(x+1)^2 = \cssId{step1}{\style{visibility:hidden}{(x+1)(x+1)}} $$
``

表格

1
2
3
4
| 一个普通标题 | 一个普通标题 | 一个普通标题 |
| ------| ------ | ------ |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |
一个普通标题 一个普通标题 一个普通标题
短文本 中等文本 稍微长一点的文本
稍微长一点的文本 短文本 中等文本

update 2017.1.9

update 2017.7.24 markdowm 格式优化