Hexo常用命令，Markdown语法

Hexo常用命令

hexo new [layout] "postName" #新建文章

hexo new page "pageName" #新建页面

hexo generate #生成静态页面至public目录

hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）

hexo d #将.deploy目录部署到GitHub 可与hexo g合并为 hexo d -g

常用复合命令

hexo deploy -g

hexo server -g

简写

hexo n == hexo new

hexo g == hexo generate

hexo s == hexo server

hexo d == hexo deploy

Markdown简介

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— 维基百科

语法

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。

类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

1
2
3
4
5
6
7
8
This is an H1
=============
This is an H2
-------------

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

1
2
3
4
5
6
# 这是 H1
## 这是 H2
###### 这是 H6

引用

引用 > 嵌套引用 >> 可根据层次加上不同数量(要依次递增)的 >

我是引用

嵌套引用

多层嵌套引用

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等
> ## 这是一个标题。

> 

> 1.   这是第一行列表项。

> 2.   这是第二行列表项。

> 

> 给出一些例子代码：

> 

> return shell_exec("echo $input | $markdown_script");

列表

Markdown 支持有序列表和无序列表。

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

*、+、-   Red

*、+、-   Green

*、+、-  Blue

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

1.  Bird

2.  McHale

3.  Parish

代码区块

和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用 <pre> 和 <code> 标签来把代码区块包起来。

要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，例如，下面的输入：

1
2
3
4
这是一个普通段落：
    这是一个代码区块。

Markdown 会转换成：

1
2
3
4
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。</code></pre>

一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制贴上，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如： 

1
2
3
4
5
6
<div class="footer">
    & copy; 2004 Foo Corporation
</div>

会被转换为：

1
2
3
4
5
6
<pre><code><div class="footer">
    & amp;copy; 2004 Foo Corporation
</div></code></pre>

代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号，这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

1
2
3
4
5
6
{ % codeblock [title] [lang:language] [url] [link text] % }
code snippet
{ % endcodeblock % }

title：代码块标题；language：语言；url：链接地址； text：链接显示名称。字段都是可选，替换时把中括号去掉。效果如下：

Java语法 我是链接
1
2
3
4
5
6
 for(int i=0; i<10; i++){
  System.out.println("Hello Hexo");
}

表格

1
2
3
4
5
6
7
8
9
10
| Item      |    Value | Qty  |
| :-------- | --------:| :--: |
| Computer  | 1600 USD |  5   |
| Phone     |   12 USD |  12  |
| Pipe      |    1 USD | 234  |

冒号是对齐方式，效果如下：

| Item | Value | Qty |

| :———— | ————:| :—: |

| Computer | 1600 USD | 5 |

| Phone | 12 USD | 12 |

| Pipe | 1 USD | 234 |

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

1
2
3
4
5
6
7
8
9
10
* * *
***
*****
- - -
---------------------------------------

区段元素

链接

Markdown 支持两种形式的链接语法： 行内式和参考式两种形式。

要建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

1
2
3
4
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记：

1
2
3
4
This is [an example][id] reference-style link.
[id]: http://example.com/  "Optional Title Here"

链接辨别标签可以有字母、数字、空白和标点符号，但是并不区分大小写，因此下面两个链接是一样的：

1
2
3
4
[link text][a]
[link text][A]

链接的定义可以放在文件中的任何一个地方，我比较偏好直接放在链接出现段落的后面，你也可以把它放在文件最后面，就像是注解一样。

下面是一个参考式链接的范例：

1
2
3
4
5
6
7
8
9
10
11
12
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
  [1]: http://google.com/        "Google"
  [2]: http://search.yahoo.com/  "Yahoo Search"
  [3]: http://search.msn.com/    "MSN Search"

可以改成用链接名称(隐式连接)的方式写：

1
2
3
4
5
6
7
8
9
10
11
12
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
  [google]: http://google.com/        "Google"
  [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
  [msn]:    http://search.msn.com/    "MSN Search"

强调

Markdown 使用星号（）和底线（_）作为标记强调字词的符号，被 或 包围的字词会被转成用 <em> 标签包围，用两个 * 或 包起来的话，则会被转成 <strong>，例如：

1
2
3
4
5
6
7
8
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__

会被转换成

1
2
3
4
5
6
7
8
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>

你可以随便用你喜欢的样式，唯一的限制是，你用什么符号开启标签，就要用什么符号结束。

强调也可以直接插在文字中间：

1
2
un*frigging*believable

但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。

如果要在文字前后直接插入普通的星号或底线，你可以用反斜线：

1
2
\*this text is surrounded by literal asterisks\*

代码

如果要标记一小段行内代码，你可以用反引号把它包起来（`），例如：

1
2
Use the `printf()` function.

如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：

1
2
``There is a literal backtick (`) here.``

图片

很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

行内式的图片语法看起来像是：

1
2
3
4
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

一个惊叹号 !

接着一个方括号，里面放上图片的替代文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。

参考式的图片语法则长得像这样：

1
2
![Alt text][id]

「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：

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

到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 <img> 标签。

其它

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：

1
2
<http://example.com/>

邮址的自动链接也很类似，只是 Markdown 会先做一个编码转换的过程，把文字字符转成 16 进位码的 HTML 实体，这样的格式可以糊弄一些不好的邮址收集机器人，例如：

1
2
<address@example.com>

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em> 标签），你可以在星号的前面加上反斜杠：

1
2
\*literal asterisks\*

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

Markdown 免费编辑器

Windows 平台

MarkdownPad

MarkPad

Linux 平台

ReText

Mac 平台

Mou

在线编辑器

Markable.in

Dillinger.io

浏览器插件

MaDe (Chrome)

高级应用

Sublime Text 2 + MarkdownEditing / 教程

参考文章

1、hexo你的博客

2、hexo的代码高亮

3、markdown简明语法

4、Markdown 语法说明