Markdown语法总结

一、标题

# 一级标签

## 二级标题

###

####

and so on ...

二、锚点

Coding 会针对每个标题，在解析时都会添加锚点id，如

# 锚点

会被解析成：

<h1 id="user-content-锚点">锚点</h1>

注意我们添加了一个user-content-的前缀所以如果要自己添加跳转链接要使用markdown的形式，且链接要加一个’user-content-‘前缀，如：

[问内链接](#user-content-锚点);

三、引用：

只需要在整个段落的第一行最前面加上 > ：

> Coding.net 为软件开发者提供基于云计算技术的软件开发平台，包括项目管理，代码托管，运行空间和质量

区块引用可以嵌套，只要根据层次加上不同数量的 > ：

> 这是第一级引用。

>

> > 这是第二级引用。

>

> 现在回到第一级引用。

四、列表

无序列表：使用星号、加号或是减号（* + -）作为列表标记

有序列表：使用数字接着一个英文句点

如果要在列表项目内放进引用，那 > 就需要缩进：

代办列表: 表示列表是否勾选状态

- [ ] 不勾选

- [x] 勾选

五、代码

只要把你的代码块包裹在 ``` 之间，你就不需要通过无休止的缩进来标记代码块了。 在围栏式代码块中，你可以指定一个可选的语言标识符，然后我们就可以为它启用语法着色了。

```ruby

require 'redcarpet'

markdown = Redcarpet.new("Hello World!")

puts markdown.to_html

```

六、强调

在Markdown中，可以使用 * 和 _ 来表示斜体和加粗。

*Coding，让开发更简单*

_Coding，让开发更简单_

七、自动链接

方括号显示说明，圆括号内显示网址， Markdown 会自动把它转成链接，例如：

[超强大的云开发平台Coding]( http://coding.net)

八、表格

在 Markdown 中，可以制作表格，例如：

```

First Header | Second Header | Third Header

------------ | ------------- | ------------

Content Cell | Content Cell | Content Cell

Content Cell | Content Cell | Content Cell

```

九、分割线

在 Markdown 中，可以制作分割线，例如：

---

十、上下标

\^表示上标, _表示下标。如果上下标的内容多于一个字符，要用{}把这些内容括起来当成一个整体。上下标是可以嵌套的，也可以同时使用。 例如：

x^{y^z}=(1+{\rm e}^x)^{-2xy^w}

十一、图片

Markdown 使用了类似链接的语法来插入图片, 包含两种形式: 内联 和 引用.

内联图片语法如下:


或


也就是:

一个感叹号: ! ; 紧跟一对方括号, 包含了可选填的图片 alt 属性; 紧跟一对圆括号, 包含了图片的 URL 或者路径, 以及一个可选的用单引号或双引号包裹的 title 属性.

引用图片语法如下:

![Alt text][id]

“id” 是图片引用的名称. 图片引用使用链接定义的相同语法:

[id]: url/to/image "Optional title attribute"