Markdown在线写作速成

到底Markdown 是什么？

Markdown是Aaron Swartz 跟John Gruber共同设计的排版语言。Markdown 的理念是，能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。写作者用Markdown格式来写作，Markdown格式会自动将内容转化为HTML格式，然后在网络发布内容。

Markdown和HTML的关系

《为什么我们要学习 Markdown 的三个理由》一文提到了两者的关系：

• Markdown 可将你输入的任何文本转为 HTML，你可以用它来编写博客、文档和网页。你还可以直接在 Markdown 文档中书写 HTML，如果某些功能 Markdown 不具备的或者你忘记了语法，你可以直接用 HTML 来编写，因为 Markdown 能理解两种格式。

• 你不一定需要在你的网站上安装 Markdown 就可以使用它，它是一个非常方便的写作语言，如果你不想转为 HTML ，Markdown 仍是很好的用来格式化纯文本的方法，无需一些富文本编辑器。但如果你需要发布到 Web 上，当然 HTML 是最适合的。

Markdown 有哪些好处？

举例来说，流行的Wordpress博客软件在编写稿件时有两种编辑模式，一种是可视化编辑器模式，另外一种是HTML编辑模式。我有多年的Wordpress博客软件使用经验，投入大量的时间在编辑排版文稿。很多时候，我是在编辑其他作者撰写的稿件，以及其他编辑粘贴的初稿。

粘帖的稿件通常带有其他软件的格式标签，在Wordpress编辑器里这些格式都显示为冗余的代码，为了清楚这些格式，以及保证整洁的版式，我通常都是直接在HTML模式下编辑这些文稿。

如果写作者都使用Markdown来写作自己的文稿，那么网站的编辑就可以节省大量的时间，不需要耗费精力在调整格式标签上。目前大量的国外博客写手已经使用支持Markdown的出版平台，或者在支持Markdown的软件里写作，再直接拷贝粘帖发布在Wordpress编辑器里。

Markdown提供一个标准化的格式，让在线文本传播更简便。

对于写作者来说，使用Markdown的好处比起其他格式来说，更能专注在写作本身，将投入在排版上的精力节省下来，投入在写作本身，提高写作效率和创作体验。

阳志平在《Markdown写作浅谈》时说到：

• 难以专心：写Word文档的时候，我们经常浪费大量时间在Word本身上，特别是那80%我们用不到的功能。比如，找借口，Word又出问题了；或者，又要升级了。其实，在内心偷笑，哈哈，可以偷懒了。

• 浪费力气在排版上：使用Word时，我们会花费大量力气去排版，试图让文档变得漂亮一些。是粗体还是斜体，是宋体还是黑体，对创作来说，有那么重要吗？

• 在用Word写作的时候，经常浪费大量时间去思考排版，但是因为Markdown足够简单，你无法思考排版，也没必要思考，所以，逼自己集中精力写作。Markdown语法因为格式足够简单，所以，导致开发者非常容易生成漂亮的版式，一切既有的CSS都可以简单修改之后套用。

在信息环境愈加纷繁复杂的当下，书写已经成为一个奢侈的习惯，对于期望更写出更多文字的朋友，使用Markdown来写作无疑能够提高更多的输出，创造更多的成果，分享更多的思考，激发更多的交流。

Markdown帮助写作者提高写作效率，优化写作体验

---

学习Markdown的八个基本标签

Markdown语法有很多标签，对于初学者来说，可以先从下面这个八个基本标签开始。实际上，这八个基本标签也是最经常使用到的标签，掌握这几个标签，基本上就可以胜任大部分的排版需求。

• 标题
• 加粗
• 斜体
• 块引用
• 链接
• 图片
• 列表
• 分割线

标题

在标题那一行的最前面加上#号，1个#号代表1级标题，2个#号代表2级标题。最多你可以写出6级标题。

标题1

标题2

标题3

标题4

标题5

标题6

# 标题1

## 标题2

### 标题3

#### 标题4

##### 标题5

###### 标题6

加粗

在你想要加粗的文字前后加上两个星号(*)或者两个下划线(_)

例如：

这是特别需要强调的地方。

这是特别**需要强调**的地方。

斜体

在需要用到斜体的地方前后加上一个星号(*)或者一个下划线(_)

《孙子兵法》的英文译名为The Art of War

《孙子兵法》的英文译名为*The Art of War*

块引用

在你引用的文字的第一行的最前面加上一个（>）这个符号，整段文字都会以缩进形式显示。

例如：

「1978年4月，有一天我突然想写小說。…当天下午我正在看棒球，坐在外野区，一边喝着啤酒。…」

> 「1978年4月，有一天我突然想写小說。…当天下午我正在看棒球，坐在外野区，一边喝着啤酒。…」

链接

在你想要加链接的文字前后用中括号[ ], 然后紧接着加上URL网址链接，前后用小括号。

例如：

《WEEx开放品牌计划说明》是在2013年4月4日发布的。

《[WEEx开放品牌计划说明](http://sociallearnlab.org/2013/04/07/weex/)》是在2013年4月4日发布的。

图片

想要在内容里插入图片，你需要先把图片上传到网络上某个公开发表的地方，或者你自己的网站空间，然后获取到图片的URL地址。

类似链接，在最前面加一个感叹号(!)，然后中括号[ ]里面是图片的文件名, 再紧接着加上图片的URL网址链接，前后用小括号。

例如：

![WEEx_logo](http://sociallearnlab.org/SLL/sociallearnlab/uploads/2013/04/WEEx-logo.png)

列表

无序列表可以使用星号，加号或者减号（*、+、-）创建，它们三者效果都是一样的。

例如

WEE 相关链接：

• WEE 教育大发现社区 wiki 页面
• WEE 豆瓣小站
• WEE 新浪微博 @joinwee
• WEE Google Plus
• WEE BagTheWeb
• WEE Flickr

- WEE 教育大发现社区 wiki 页面

- WEE 豆瓣小站

- WEE 新浪微博 @joinwee

- WEE Google Plus

- WEE BagTheWeb

- WEE Flickr

分割线

要添加分割线非常简单，直接在一个空行里打上三个星号(***)。

例如：

---

***

---

动手练习Markdown在线写作

看了这么多，你是不是手痒痒的，想要马上试试？

开源中国社区提供了一个在线 Markdown 编译器, 你可以对照这个微课的介绍，练习一下每个语法。

---

实际演练，熟能生巧

掌握一门技能的最好方式是在理解原理之后，投入实际使用，通过实际演练熟能生巧，将这些技能内化为自己的知识。

上面推荐的编译器只可以用来测试练习，无法保存，并且产出一些作品。下面推荐几个可以实际使用的支持Markdown的工具。

JoinWEE.com

是的，你看到的这个内容就是用Markdown写的。来这里创建微课，我们用Markdown做编辑器。选择一个你最拿手的知识领域或者学习行动，将它改写成一个微课，分享你的哦知识心得，并且练习Markdown。

BagTheWeb.com

这是一个让用户打包网络资讯并且整理自己的知识心得的工具。它的Blurbs(原创随笔)功能支持Markdown写作。你可以在一个包里写收纳多个网络资讯，并且写多条短随笔，整理对于某个议题的思考。 免责申明：笔者是该网站的开发成员。

Logdown.com

Logdown 是台湾一个博客写手和开发者在一个周末和三位朋友在24小时之内做的一个Hackathon 項目。这是一个支持Markdown的博客写作平台。在国际上也引起关注。它的写作界面是单栏宽屏。

简书 | Jianshu.io

这是一个支持Markdown的中文写作社区。目前的模样看起来类似英文写作社区Medium.com，但实际上它们的原始初衷是开发一个云笔记应用，后来殊途同归，演化为类Medium的网站。它的写作界面是两栏，一栏为效果预览，一栏为Markdown写作。

有记 | noteton

有记提供基于云笔记服务的博客发布平台。创始人多年一直折腾，醉心于打造一个舒服好用的在线写作平台，凭这个劲儿你也要去支持一下。

---

友情提醒

• 这个微课只是入门，这八个标签都有多种语法，我只介绍1-2种。

• Markdown语法不会控制最终的视觉显示效果，不同网站的CSS样式会设定不同的视觉设计效果。例如：1级标题，在Markdown是一个标签，当时同一个Markdown文档，张贴在不同的网站上，1级标题的字号大小，字体样式，颜色这些都会不同。

• 每个标签都要用半角字符，并且和后面的正文之间需要空格，不能紧挨在一起。

---

高级技巧

• 如果你想比对Markdown和HTML的一对一转换，请参考这里《知乎问答：Markdown 是什么？》。

• 如果你想深入了解科技写作与Markdown+R，请参考这里《Markdown写作浅谈》。

---

微聚活动创意：#Markdown翻翻团

如果你学习了这个微课之后，想要举办线下微聚活动，可以参考这些构思：

• 寻找同城热衷Markdown的朋友，组团行动

• 以在当地城市推广Markdown为宗旨

• 借助一些行为艺术的创意来设计活动形式，例如在大学校园，找八个大学生，每个人前面挂一个字母，组成MARKDOWN，然后其中四个人背后挂上HTML四个字母。大家排成一排，站在教学楼，或者食堂门口，然后背后挂上HTML字母的四个同学和其他同学，每隔几分钟转身一下。

• 你们的组团行动可以命名为： #Markdown翻翻团#

---