简书江湖中传说中专注于书写的高效写作工具Markdown，到底是什么鬼？
昨天，我花了1个多小时，对markdown写作相关的语法进行了学习，并总结了常见的几个问题。如果你也感兴趣，欢迎围观。
# 一、学习笔记 #
## 1、标题 ##
标题是写作中最常用的格式。
在Markdown中，语法如下：
在文字前面加上 #，并在 # 后加一个空格。
标题总共六级，只需要增加 # ，增加一个 # ，标题字号相应降低一级。
##### 示例代码如下： ####
# h1 一级标题
## h2 二级标题
### h3 三级标题
#### h4 四级标题
##### h5 五级标题
###### h6 六级标题
## 2、列表 ##
写作中，列表常用来梳理文章的条例。
### 2.1无序列表和有序列表 ###
在 Markdown 中，语法如下：
无序列表：在文字前面加上 - 。
有序列表：在文字前面加上 1. 2.3.。
注：-、1.和文字之间要保留一个字符的空格。
##### 示例代码如下： ####
###无序列表
- 跑步
- 整理读书笔记
###有序列表
1. 跑步
2. 整理读书笔记
### 2.2待办和清单 ###
在Markdown中，语法如下：
在文本或者清单文本前加上- [ ]、- [x]。
- [ ] 表示未完成，- [x] 表示已完成。
注：键入字符与字符之间都要保留一个字符的空格。
##### 示例代码如下： ####
###待办列表
- [ ] 待办项
- [x] 已完成项
- [x] 已完成项
- [x] 已完成项
## 3、引用 ##
如果在文章中引用一段别处的句子，那么就要用到「引用」格式。
在Markdown中，语法如下：
在引用文字前加上 > 并与文字保留一个字符的空格，即可。
##### 示例代码如下： ####
> 曾国藩说，知而不行，是未知。
## 4、常用文字格式 ##
### 4.1斜体与粗体 ###
#4.1 基础语法#
在Markdown中，语法如下：
斜体：用一个 * 包含一段文本；
粗体：用两个 ** 包含一段文本；
#4.1 扩展语法#
加粗并斜体：用三个 * 包含一段文本。
注：符号与文本之间无需空格。
##### 示例代码如下： ####
*斜体文字*
**加粗文字**
***加粗斜体文字***
### 4.2其他较常用格式 ###
在Markdown中，语法如下：
下划线：用两个++包含一段文本；
划掉：用两个~包含一段文本；
高亮：用两个=包含一段文本。
##### 示例代码如下： ####
++下划线++
~~划掉~~
==待高亮的文字（有道云笔记支持，简书和evernote不支持）==
## 5、链接与图片 ##
### 5.1 链接 ###
在Markdown中，语法如下：
链接：[显示文本](图片链接地址)
##### 示例代码如下： ####
[【简明版】有道云笔记Markdown指南](http://note.youdao.com/iyoudao/?p=2411)
[【进阶版】有道云笔记Markdown指南](http://note.youdao.com/iyoudao/?p=2445)
### 5.2 图片 ###
在Markdown中，语法如下：
图片：
##### 示例代码如下： ####
注：插入图片的语法和链接的语法很像，只是前面多了一个 ！
## 6、分割线 ##
分割线用于分割两段内容。Markdown语法有两种：
a. 另起一行，连续输入三个星号 *** 。（官方推荐）
b. 空一行，然后另起一行连续输入三个 ---。（亲测可用）
##### 示例代码如下： ####
01 引子
02 故事
---
03 小结
## 七、表格 ##
在Markdown文稿中键入表格，语法代码如下：
|表头1 | 表头2|
| --- | --- |
|row 2 col 1 | row 2 col 2|
|row 1 col 1 | row 1 col 2|
注：默认插入的表格为2行3列(含表头1行)。
#### 扩展知识 ####
如需增加行或列，需先增加列。
增加列：文本后增加|。
##### 示例代码如下： ####
3行3列(含表头)
| 文章标题 | 阅读数 | 关注数 |
| --- | --- | --- |
| 文1 | 125 | 36 |
| 文2 | 86 | 12 |
**注意事项(4.16更新)**
- 前后的|必须加上且表头前需空一行，否则不能正常显示。
- MD语法中，最好各语句块都空行，以免出错。(tamlok同学的建议)
如上七大格式是写作文稿时最常使用的。
**更新说明**
感谢tamlok同学协助解决 编辑器中MD不能显示表格的问题。有兴趣的同学，可以参考他这篇[Vim与Markdown，实现键不离手](http://www.jianshu.com/p/fa8c56e1aa52) 。
## 二、相关问题 ##
### 1. 刚开始使用Markdown，经常会忘记相关语法。 ###
- 使用有道云笔记的同学
有道云笔记的工具栏内置了Markdown语法，可以方便学习与熟悉。
如「表格」语法相对复杂，你可能忘记了，怎么办呢？
这时候，你只需要点击编辑框上方工具栏，点选「表格」的图标，左边编辑区便会出现「表格」相应代码。然后，你只需要将代码替换成相应文本即可。
- 使用evernote的同学
建议使用马克飞象，或者作业部落的编辑器。
### 2. 想插入本地图片，如何处理呢？ ###
- 感兴趣且有编程基础的同学可直接移步[Markdown中插入图片有什么技巧？](https://www.zhihu.com/question/21065229)的回答。
- 想直奔答案的同学，建议使用富文本方式插入，或者换个更称手的编辑工具。
强烈推荐大辉船长在[一键搞定公众号排版：简书+浏览器插件MarkdownUI Here](http://www.jianshu.com/p/a754957c92e1)中推荐的[WangEditor](http://www.wangeditor.com/)。
##### 推荐理由 #####
我花了1小时时间学会的Markdown语法，却发现这个编辑工具比Markdown更适合不太擅长代码的我。
仅试了一次，就决定只用它了！
#### 3. 如何设置字体、文字颜色和背景呢？ ####
Markdown生成的是HTML，而HTML是不表达样式的。字体、颜色、布局这些样式是由CSS来控制的。
如果你确实需要设置这些内容，[石墨文档](https://shimo.im/desktop)
#### 4.Markdown语法和富文本格式可以混合书写吗？ ####
用Markdown语法写作过程中 ，我们可以免除点击工具栏进行切换的“干扰”，集中注意力在书写这件事上。可是，插入图片这种操作，对于不熟悉编码操作的同学还是富文本比较快。
要是能混合书写就好了，可是答案是"It cannot do it!（它不能）"。只能说超级可惜(可惜状，大家自行脑补哈)。
#### 5.是否有Markdown相关的源码可学习？ ####
因百度云盘分享有问题，暂无法分享链接。如需参考源码，可移步[实践笔记|Markdown学习笔记源码（图片版）](http://www.jianshu.com/p/e9464fc9b7b8)
小提示：源码均在 简书编辑器 中测试通过，请放心使用。
## 三、写在最后 ##
有些工具，玩过了才知道爽。
对于纯文本或仅含少许图片的文章来说，Markdown无疑是专注和高效的利器。
可是对于一个对排版和书写有同等高要求的我来说，我对Markdown的感觉是“累觉不爱”。
我选择的排版工具是——
大辉船长在[一键搞定公众号排版：简书+浏览器插件MarkdownUI Here](http://www.jianshu.com/p/a754957c92e1)中推荐的[WangEditor](http://www.wangeditor.com/)。
如果你有更好的简书能兼容的排版工具，欢迎交流~~
**
我是雪夜闻笛，在写作的路上，愿我们一同精进！
