导语
Markdown是一种可以使用普通文本编辑器编写的标记语言，通过类似HTML的标记语法，它可以使普通文本内容具有一定的格式，也就是说用简单语法代替排版。
Markdown优点很多，属于十分轻量级的语言，其语法非常简单，比HTML简单太多，主要的用途是写文章，写作爱好者和撰稿者很有必要学习，这样可以为你部署文章格式节约很多时间，而且不到一个小时就能轻松学会。
正文
编译器
用什么来写Markdown文档呢？
在 Mac OS X 上，我用的是Mon，它支持实时预览，既左边是你编辑 Markdown 语言，右边会实时的生成预览效果（如下图）。
除此之外，Mou 还可以设置主题（Themes）与样式（CSS），它们可以配置出定制化的文本编辑效果，还可以到 GitHub 上搜索其它爱好者为 Mou 编写的更多主题样式，导入的方式可以在偏好设置（Preference）的 Themes 或 CSS 选项中 选择 reload。
其他设备推荐的编辑器，我放到一个表格里，不一一的介绍了。
| Windows |
iOS端(很多app都支持) |
Web端 |
| MarkdownPad |
Drafts，Day One，iA writer 等 |
简书 |
| MarkPad |
Ulysses for iPad（强烈推荐） |
|
经常使用的Markdown语法
我都用Markdown的编译器截图粘出来，可以很清楚的学会如何使用，左边是代码，右边是效果图。
1、标题
最小到六级标题
2、图片和链接
这两个的使用非常相似，只有有无！的区别，[]里面是描述，()里面是路径和真正的链接。插入图片的地址需要图床，这里推荐CloudApp，它提供了一个较为轻量级的网络存储服务，可以把图片放到上面，然后得到超简洁的短地址。
自动链接，直接加<>就行。
3、列表
Markdown分有序列表和无序列表，无序列表是在文字前面加-或者*，有序列表加1. 2. 3.就行。注意：符号和文字间需要加一个空格。
4、粗体和斜体
粗体语法：用两个 * 或者 _ 包含一段文本
斜体语法：用一个 * 或者 _ 包含一段文本
5、代码框
语法：用两个 ` 把中间的代码包裹起来
或者两边各用三个 ` 把中间的代码包裹起来
6、表格
说明：冒号：的左右是表示左对齐，右对齐，居中的效果。
7、分割线
换行，然后用三个 * 或者 _ 即可。
8、引用
只需要在文本前加入尖括号 > 即可。
9、颜色
markdown支持内联html，遇到特殊的样式可以直接写原生的html。
10、空格
因为markdown的段落定义是由一个或多个连续的文本组成，中间的多个空格和tab会被认为是一个空格。
但是有时候确实需要这样的空格或tab缩进格式时怎么办?
使用全角空格，全角空格被解释为汉字，所以不会被被解释为HTML分隔符，可以按照实际的空格数显示。
基本语法到此结束，掌握了这些，基本就可以搞定各种格式的文章了，祝大家能领略到Markdown的美！
官方帮助文档
上一篇博文的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
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
| ---
layout: post
title: github+hexo 搭建博客教程
comments: true
tags:
---
前几天搭建好了自己的博客，中间遇到很多问题，跟大家分享一下我的经验，希望可以对大家有帮助（针对Mac）。
前段时间一直想搭建自己的博客，由于自己有两个要求，一需要托管在github（之前有一些项目在github上，对git比较熟悉），二比较倾向于Markdown（语法简洁明了、学习容易，而且功能比纯文本更强），所以自然选择了hexo。
从开始着手到搞定用了2天的时间，中间遇到各种坑，终于搭建好了hexo。跟大家分享一下我的经验。
备注：我的hexo版本是3.1.1，而且教程是针对Mac的。
`$ sudo brew install git`
如果安装成功，检查是否能用
`$ git`
如果出现错误：
说明Terminal 可以在 $PATH 环境变量中没有找到git，所以需要配置。
打开安装目录，类似：
`$ cd /usr/local/Cellar/git/2.1.2`
`$ open ~/.bash_profile`
在bash_profile文件$PATH 环境变量中添加git/usr/local/Cellar/git/2.1.2/bin/git（当然这是根据自己安装的路径）
`$ source ~/.bash_profile`
使对bash_profile文件的修改立即生效。
用`$ which git`再检查一次，如果输出是/usr/bin/git就对了。
**注意**：如果大家安装的目录跟我不同，直接将/usr/local/Cellar改成自己的目录即可，我的git版本是2.1.2
这个我就不啰嗦了，在[github官网](https://github.com/)上直接按步骤就行。
另外，申请好后，可以配置一下SSH Keys。
1. `$ ssh-keygen`,然后连续敲3次回车就可以了，生成的SSH key文件保存在中～/.ssh/id_rsa.pub。
2. 用文本编辑器打开id_rsa.pub文件，拷贝.ssh/id_rsa.pub文件内的所有内容，将它粘帖到github帐号管理中的添加SSH key界面中。
1. 登录github
2. 点击右上方的Accounting settings图标
3. 选择 SSH key
4. 点击 Add SSH key
SSH Keys也可以不配置，缺点：
1. 每天提交的时候需要写账号和密码。
2. 使用git clone命令从github上同步github上的代码库时，如果使用SSH链接，系统会报错：
配置完SSH Keys再设置一个全局变量
`$ git config --global user.name "Your Name"`
`$ git config --global user.email "email@example.com`
你github的用户名和申请邮箱。
1. [官网下载页面](http://nodejs.org/#download)下载。
2. ./configure
3. make
4. sudo make install
git和node安装成功后才能安装Hexo
`$ npm install -g hexo`
**安装的工作终于到此结束！！**
安装完成后，在你准备写博文的文件夹（例如：F:\Blog）下，初始化Hexo，Hexo 即会自动在目标文件夹建立网站所需要的所有文件，一下就把这个文件夹叫做Hexo根目录。
`$ hexo init`
`$ npm install`
`$ hexo generate`
`$ hexo g`也可以
**但是发现有问题：**
google之后，发现原来是npm的版本问题
修改package.json文件：
将中间的*全部改为0.1，就搞定了。
`$ hexo server`
然后浏览器中输入浏览器输入<http://localhost:4000>
成功之后会出现：
快捷键'ctrl + c'关闭server
这样本地博客就搭建成功了，可以进行预览调试，但是只能自己看到，但是现在域名和服务器都是基于自己的电脑，其他人看不到。
1. 登录github后，将鼠标点击github右上角“+”号，在下拉菜单上，选择“New repository”项，填写库名称（名称格式：xxxxx.github.io，我的是SolaCode.github.io），点击“create repository”，即可完成创建库。
2. 修改配置文件，在自己建的文件夹(F:\Blog)下找到_config.yml文件，里面的author:和url:改成自己的就可以，然后翻到最下边，修改Deployment部分（很重要），如下图：<br>
3. 执行下列指令即可完成部署。
`$ hexo generate`
每次修改完本地文件后，都要hexo generate才能保存。
`$ hexo deploy`
现在，属于自己的博客就完全搭建成功了，在浏览器访问 SolaCode.github.io 就能发布成功了！大家都可以观赏你的博客了！
上面部署的是自动生成的博客，接下来，就可以自己新建了。命令如下：
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口（默认端口4000，'ctrl + c'关闭server）
hexo deploy #将.deploy目录部署到GitHub
帮助命令：
hexo help # 查看帮助
hexo version #查看Hexo的版本
我说的美化主要是指主体的使用，我用的主题是[Yilia](https://github.com/litten/hexo-theme-yilia)，github上有很多好看的Hexo主题，都可以选择clone。我简单介绍下如何换主题。
1. clone主题
2. 修改hexo根目录下的 _config.yml文件，修改文件中的theme部分。<br>
3. 如果想修改头像可以直接在主题的_config.yml文件里面修改。我主要改了这两部分。<br>
4. 更新
`$ cd themes/yilia`
`git pull`
5. 在Hexo根目录下部署提交
`$ hexo clean`
`$ hexo generate`
`$ hexo deploy`
6. 在浏览器访问[https://SolaCode.github.io](https://SolaCode.github.io)<br>
通过前面的教材，你会发现你已经掌握了Hexo的基本常用命令，如果只是用来写博客，差不多就够用了。
下面说说我自己心得，在安装过程中，会遇到各种各样的问题，最重要的是有耐心，踩的坑，相信很多人都遇到过，网上有前辈们已经找到了解决方案，要善于利用google。
1. 文章在source/_posts，支持Markdown，我用的是用Mon打开。
2. source/img中，可以放一些文章中需要插入的图片。
下次我会分享Markdown的入门，还有基础语法。也会把这篇博文的源码粘出来，供大家参考。
|