Markdown

Markdown Cheatsheet

最近在转向使用markdown进行日常笔记的工作，编辑器目前使用chrome app stackedit, 支持markdown基本语法和latex公式输入，能够以html页面发布，同步到google drive和dropbox，或者发布到blogger, wordpress, github, 基本能够满足工科僧的需求。Markdown支持html标签内嵌，如果你懂得少量的html语言，就能够制作出更美观的文本。PC端刚刚开始试用Sublime Text 2，尚在熟悉中。

入门教程主要是以下两项：

在Google上发现了一个更加实用的cheatsheet，在这里做一下翻译（内联HTML和Youtube部分未译），顺便巩固一下语法。个人比较推荐列表 和表格部分，比其他教程详细一些。

Headers

用#表示标题

1
2
3
4
5
6
# H1
## H2
### H3
#### H4
##### H5
###### H6

效果如下

H1

H2

H3

H4

H5
H6

强调

基本上每个Markdown教程都会有的内容，将你的双手从鼠标中解放出来，可以用比latex更简洁的方式完成粗体，斜体，又是加粗又是斜体的操作。

1
2
3
4
5
6
7
使用*asterisks*(星号)或者_underscores_(下划线)表示斜体.

使用双份的星号或者下划线**asterisks**, __underscores__表示粗体.

星号和下划线一起上就是加粗+斜体了 **asterisks and _underscores_**.

使用波浪线表示删除线 ~~Scratch this.~~

使用asterisks(星号)或者underscores(下划线)表示斜体.

使用双份的星号或者下划线asterisks, underscores表示粗体.

星号和下划线一起上就是加粗+斜体了 asterisks and underscores.

使用波浪线表示删除线 Scratch this.

注删除线似乎是增强版Markdown的功能，StackEdit不支持

列表

在codebox中，空格用‘.’来占位 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
1. 有序列表的第一项条目
2. 再加一条
..* 无序子列表
1. 标号并不重要，Markdown会自动更新序号
..1. 有序子列表
4. 第四项条目

...注意上面的空行，和本段开头的空格（至少需要一个空格，在这里用了三个方便对齐:P）

...如果想要回车又不想新起一个段落，在断尾加两个空格??
...本行单独成行，但是没有产生新的段落??
...在GFM风格的段落中，行尾不需要空格

* 用asterisk表示无序列表
- 减号也可以
+ 加号也可以
  1. 有序列表的第一项条目
  2. 再加一条
    • 无序子列表
  3. 标号并不重要，Markdown会自动更新序号
    1. 有序子列表

  4. 第四项条目

    注意上面的空行，和本段开头的空格（至少需要一个空格，在这里用了三个方便对齐:P）

    如果想要回车又不想新起一个段落，在断尾加两个空格
    本行单独成行，但是没有产生新的段落
    在GFM风格的段落中，行尾不需要空格

  • 用asterisk表示无序列表
  • 减号也可以
  • 加号也可以

链接

也读作传送门:P
有两种生成链接的方法，行内式或者参考式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[行内式链接](https://www.google.com)

[带标题的行内式链接](https://www.google.com "Google's Homepage")

[参考式链接][Arbitrary case-insensitive reference text]

[指向代码仓库文件的相对路径](../blob/master/LICENSE)

[参考式链接可以使用数字序号][1]

或者使参考文字为空 [链接文字][]

参考式链接的地址可以出现在后面

[arbitrary case-insensitive reference text]: https://www.mozilla.org
[1]: http://slashdot.org
[链接文字]: http://www.reddit.com

行内式链接

带标题的行内式链接

参考式链接

指向代码仓库文件的相对路径

参考式链接可以使用数字序号

或者使参考文字为空 链接文字

参考式链接的地址可以出现在后面

插入图片

插入图片和插入链接的语法很像，只是前面多了一个!

1
2
3
4
5
6
7
8
9
以Markdown Here的logo为例:

行内式插入: 
![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1")

参考式插入: 
![alt text][logo]

[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 2"

以Markdown Here的logo为例:

行内式插入:
alt text

参考式插入:
alt text

代码与语法高亮

程序猿同行看这里了喂$\rightarrow$

代码块是Markdown的特性之一，但语法高亮并不是。部分渲染器支持语法高亮，比如Github和Markdown Here(很遗憾StackEdit不支持语法高亮的特性). 可以戳这里查看highlight.js支持的语言和高亮效果。

1
对于行内`代码`，只需要用`\`\``把它们框起来就可以了

对于行内代码，只需要用`` 把它们框起来就可以了

1
对于大段的代码块，用` ``` `把他们框起来，或者在段首留4个空格的缩进也可以。

对于大段的代码块，用` 

1



1
2
var s = "JavaScript syntax highlighting";
alert(s);
1
2
s = "Python syntax highlighting"
print s
1
2
No language indicated, so no syntax highlighting. 
But let's throw in a <b>tag</b>.
1
2
3
4
5
6

上面的那段代码看起来就像这样 

 ```javascript
 var s = "JavaScript syntax highlighting";
 alert(s);
1
2
s = "Python syntax highlighting"
print s
1
2
No language indicated, so no syntax highlighting. 
But let's throw in a <b>tag</b>.

表格

表格也不是Markdown的核心功能(没办法，Markdown的设计思想就是轻量简洁)，但是对于时常需要记录实验数据的po主，表格是不可或缺的功能。好在GFM, Markdown Here, StackEdit都支持了表格功能。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
冒号用于对齐

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | \$1600 |
| col 2 is      | centered      |   \$12 |
| zebra stripes | are neat      |    \$1 |

外侧的'|'可以被省略，就像下面的表格这样。

Markdown | Less | Pretty
--- | --- | ---
*Still* | `renders` | **nicely**
1 | 2 | 3

冒号用于对齐

Tables Are Cool
col 3 is right-aligned \$1600
col 2 is centered \$12
zebra stripes are neat \$1

外侧的’|’可以被省略，就像下面的表格这样。

Markdown Less Pretty
Still renders nicely
1 2 3

引用

1
2
3
4
5
6
> 引用在email中是很常见的功能。
> 这行也是同一引用块的内容

引用完毕。

> 让我们来看看引用一大段文字会怎样。我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的。占位完毕！引用区块*内部*也支持**Markdown**语法

引用在email中是很常见的功能。
这行也是同一引用块的内容

引用完毕。

让我们来看看引用一大段文字会怎样。我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的我是只是来占位的。占位完毕！引用区块内部也支持Markdown语法

喜闻乐见的分割线

1
2
3
4
5
6
7
8
9
10
11
12
13
连续三个或更多的链接符，星号和下划线将产生分割线

---

链接符

***

星号

___

下划线

连续三个或更多的链接符，星号和下划线将产生分割线

链接符

星号

下划线

空行

作者关于空行的建议是——多试几次。那就一起试试看吧～

1
2
3
4
5
6
起始行。

敲击两下回车，产生一个新的段落

再起一段...
这是单独的一行但不是与上一行同属一个*段落*

起始行。

敲击两下回车，产生一个新的段落

再起一段…
这是单独的一行但不是与上一行同属一个段落

教程的部分告一段落，突然发现要整理出一份好用的tutorial也是挺费功夫的一项工作，向精心撰写文档的原作者和孜孜不倦地进行技术翻译工作的Geek们致敬！