Wang Lichao home

markdown语法

01 Jan 2015 - 青岛

什么是Markdown语法?

Markdown 是一种轻量级标记语言,目标是实现「易读易写」。

标题

在Markdown中,你只需要在文本前面加上# 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加# 即可,标题字号相应降低。例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

点击预览可以看到效果:

在这里输入图片描述

###引用 Markdown 标记区块引用是使用类似 email 中用 > 的引用方式,只需要在整个段落的第一行最前面加上 > :

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

效果图如下:

在这里输入图片描述

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

> 这是第一级引用。
>
> > 这是第二级引用。
>
> 现在回到第一级引用。

效果图如下:

在这里输入图片描述

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");

效果图如下:

在这里输入图片描述

列表

列表项目标记通常放在最左边,项目标记后面要接一个字符的空格。

无序列表:使用星号、加号或是减号作为列表标记

- Red
- Green
- Blue

效果图如下:

在这里输入图片描述

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

1. Red
2. Green
3. Blue

效果图如下:

在这里输入图片描述

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

*  Coding.net有以下主要功能:
    > 代码托管平台
    > 在线运行环境
    > 代码质量监控
    > 项目管理平台

效果图如下:

在这里输入图片描述

代码

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

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

效果图如下:

在这里输入图片描述

强调

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

斜体:

*MarkDown,让开发更简单*
_MarkDown,让开发更简单_

效果图如下:

在这里输入图片描述

加粗:

**MarkDown,让开发更简单**
__MarkDown,让开发更简单__

效果图如下:

在这里输入图片描述

自动链接

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

[0532-github](https://github.com/0532)

效果图如下:

在这里输入图片描述

或者也可以直接用< >,将网址或者邮箱地址放在中间,也能将地址直接转成链接:

<wanglichao@github.com>

效果图如下:

在这里输入图片描述

表格

在Markdown中,可以制作表格,例如:

```

First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell  | Content Cell
Content Cell | Content Cell  | Content Cell

```

效果图如下:

在这里输入图片描述

或者也可以让表格两边内容对齐,中间内容居中,例如:

```

First Header | Second Header | Third Header
:----------- | :-----------: | -----------:
Left         | Center        | Right
Left         | Center        | Right

```

效果图如下:

在这里输入图片描述

分割线

---

效果图如下:


Fork me on GitHub