Markdown语法 与 Hexo常用指令

Markdown是一种超轻量级的标记语言，常用的标记符号不超过十个，相对于更为复杂的HTML标记语言来讲，Markdown实在简便多了，因此学习成本也不是很大。更多关于Markdown的认识，我们可以参考：认识与入门 Markdown

Markdown工具

关于支持Markdown的书写工具网络上有很多推荐，这里不再一一列举，常用的有：

Mou：外文世界对 MarkDown 的热衷在 Mac 上可见一斑，目前虽是免费的，但功能性却能比肩同类的收费软件。

Sublime Text 3：支持 OS X、Windows、Ubuntu 等 UNIX 及 Linux 操作系统，在代码工作者圈内相当出名。

MarkdownPad2：推荐较多，但是免费版的有些扩展功能受限。

小书匠：有**网页版和客户端**: 支持实时同步预览，编辑器同步滚动，多种系统内置的主题等特点。

简书：是一家由国内初创团队建立的在线文字创作及发布平台。

Cmd Markdown：Windows/Mac/Linux 全平台客户端。

常用语法

常见格式及其对应的语法：

Markdown

注释与示例:

粗体

在字体两侧分别加两个星号 ** ， 当然，也能使用快捷键 Ctrl + B 快速加粗；

斜体

将需要设置为斜体的文字两端使用一个 * （或者 _ ） 夹起来，快捷键 Ctrl + I ；

删除线

在需要设置删除线的文字两侧加两个波浪线 ~~ 夹起来，可以表示删除文字；

分割线

分割线的语法只需要三个星号*或者三个小短线 - 号，例如：

外链接

[描述](链接地址) 为文字添加外链接，可以使用快捷键 Ctrl + L 快速设置；
示例： [HarbingWang的博客](http://harbingwang.github.io)
显示： 这里是HarbingWang的博客 链接。

内嵌代码

第一种:引入单行代码出现一个代码框，需要使用键盘左上角的ESC键下面的反单引号夹在文字两侧，两侧各一个就行。

例如：\`Hellow world！`

显示：
Hellow world！

第二种：多行代码的引入需要在代码段的前后分别使用三个反单引号

显示：

for (int i = 0; i < 100; i++)
{
      printf("hello markdown!\n");
}

引入内容

第一种:通过在文字开头添加“>”表示块注释，快捷键使用 Ctrl + Q 例如；

如果你无法简洁的表达你的想法，那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦

第二种: 使用tab键或者四个空格

一个项目两部电脑三餐盒饭只为四千工资搞得五脏俱损六神无主仍然七点起床八点开会处理九个漏洞十分辛苦 
十年编码九年加班八面无光忙的七窍生烟到头六亲不认五体投地依旧四肢酸软三更加班只为二个臭钱一生孤苦

插入图片

插入图片的语法与插入链接很像，区别在一个插入图片的时候需要加一个!号

Markdown语法： 

示例：

Github

• 插入图片的地址需要图床生成图片外链，这里推荐使用七牛图床，生成URL地址即可。

• 不同Markdown工具下插入图片的方式也有所不同，这里只说明通用做法，具体可参考编辑器的使用说明；

分级标题

标题是每篇文章中最常用的格式，在Markdown语法中，如果某行文字被定义为标题，只需要在行首加上#符号即可：

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

• 是几级标题就用几个 # 符号，每增加一个 # 表示更深入一个层次的内容，总共有六级标题。

• 标准的Markdown语法需要在符号后面多加一个空格，建议加上。

上面这种设置标题的方式是最为直观的，当然在Markdown语法下，我们也可以通过在文字下方添加“=”和“-”，他们分别表示一级标题和二级标题，例如:

我是一级标题
====


我是二级标题
----

无序列表

使用一个 *，+或- 表示无序列表。

示例：

• 无序列表项 一

• 无序列表项 二

• 无序列表项 三

有序列表

使用数字和英文句点表示有序列表, 不要求数字一定要连续。

示例：

1. 有序列表项 一

2. 有序列表项 二

3. 有序列表项 三

绘制表格

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

反斜杠

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

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

以上的Markdown语法基本上足够我们书写一篇博客了，关于Markdown的高级用法，包括通过Markdown创建公式，绘制流程图等请参考本文底部的 Reference相关；

Hexo常用指令

以下关于Hexo常用指令的整理，要想熟练使用一个工具，首先就要熟练掌握他的相关指令，以便操控这一工具。下面将着重介绍几条常用的 Hexo 指令：

1、新建文章

hexo new articleName

　Note：

• 新建一篇题为“articleName”的文章，此时会在E/Hexo/source/_posts/目录下生成一份articleName.md 的文件，使用Notepad++、小书匠、MarkdownPad2等编辑工具打开即能书写；

• 提示信息：INFO Created: E:\Hexo\source_posts\articleName.md

• 如果标题包含空格，需要使用双引号括起来

2、新建页面

hexo new page pageName

　Note：

• 新建一个题为“pageName”的页面，此时会在E:\Hexo\source\目录下生成一个名为pageName的文件夹，其中包含一份 index 的md文件；

• 提示信息：INFO Created: E:\Hexo\source\pageName\index.md

• 同样地，如果语句中包含空格，需要使用双引号括起来

3、生成静态页面

hexo generate 

Note：

• 启动该条指令后会将当前网页的内容生成静态页面到public目录下

• 提示信息：
  INFO Start processing
  INFO Files loaded in 595 ms
  INFO 0 files generated in 612 ms

4、开启本地服务器端口

hexo server

Note：

• 开启预览访问的端口，默认端口为4000

• 关闭server使用 ctrl + c

• 提示信息：
  INFO Start processing
  INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

• 在使用hexo server 可能会遇到端口被占用的情况，不妨使用以下指令来更改端口

hexo server -p 4001

5、部署到Github

hexo deploy

Note：

• 将 E/Hexo/目录下的 .deploy_git 文件夹部署到Github

• 部署前需要预先 hexo generate 生成静态文件

• 关闭server使用 ctrl + c

• 提示信息：
  INFO Deploying: git
  INFO Clearing .deploy_git folder...
  INFO Copying files from public folder...
  .....部署的文件
  To git@github.com:HarbingWang/harbingwang.github.io.git
  da818a3..e4e53c6 HEAD -> master
  INFO Deploy done: git # 当看到 “INFO Deploy done: git”时即表示部署已经完成；

6、清除文件

hexo clean

Note：

• 清除E/Hexo目录下的缓存文件（db.json）和已经生成的静态文件（public）文件

• 网页正常情况下可以忽略此条命令

7、查看Hexo版本

hexo version

Note：

• 查看当前使用的Hexo的版本号

• 提示信息：
  hexo: 3.2.0
  hexo-cli: 1.0.1
  os: Windows_NT 6.1.7601 win32 x64
  http_parser: 2.6.2
  node: 5.10.0
  v8: 4.6.85.31
  uv: 1.8.0
  zlib: 1.2.8
  ares: 1.10.1-DEV
  icu: 56.1
  modules: 47
  openssl: 1.0.2g

复合指令

hexo g -d   
hexo s -d   

Note：

• hexo g -d # 等价于 hexo generate --deploy ：生成静态文件并部署

• hexo s -d # 等价于 hexo deploy --generate ：开启预览并部署到Github

简写形式

hexo n #等价于 hexo new
hexo g #等价于 hexo generate
hexo s #等价于 hexo server
hexo d #等价于 hexo deploy
hexo v #等价于 hexo version

如何卸载Hexo？

3.0.0版本执行npm uninstall hexo-cli -g，之前版本执行npm uninstall hexo -g

##　如何安装旧版本Hexo？

　先卸载当前版本，以2.8.3为例，执行npm install hexo@2.8.3 -g，再初始化并安装依赖和插件。

Reference

整理过程中难免有所疏漏，失误之处还请指正，更多详细内容请参考：

• 认识与入门 Markdown

• 解决作者们的焦虑：7 款优秀 Markdown 编辑工具推荐

• Markdown——入门指南

• Markdown：指南

• hexo常用命令笔记 【推荐】

• 极客学院Hexo中文版指令 【推荐】

• 如何搭建一个独立博客——简明Github Pages与Hexo教程