九分钟学会 Markdown

技多不压身。如果你愿意花九分钟学一个当前流行的软件技术的话,可以开始计时了。

00:00 是什么以及为什么

Markdown 是一种轻量级标记语言。好吧,我承认这不是人话。换个说法:Windows 里的记事本或办公软件 Word 你用过吧?类似的,Markdown 软件是用来在电脑里写文字的(作文、笔记、会议记录等),而功能介于记事本和 Word 之间。

那为什么要用它?因为它很流行耶!简书在用,Rstudio在用,本人的博客“晴耕雨讀志”也在用。还因为它简洁而强大耶!记事本太简陋,Word 太复杂又收费(用盗版的同学请不用举手了),而 Markdown 刚好满足平时用电脑写东西的大多数需求。甚至有时候更方便。比如想把本文里所有的“Markdown”这个词的字体加粗, Word 的初级用户只会逐个修改,大概到中级水平才会批量操作。而 Markdown 用户学一分钟就能轻松完成。马上就能,不信你试试。

00:01 初体验+换行+斜体+粗体

体验 Markdown,无需在电脑安装任何软件!本博客留言支持 Markdown,你只要在本帖后面的评论框里练手就行,框下面是预览效果。随便试,评论我不删。

请在评论框里随便敲几个字,然后按两次回车换行,再敲几个字。试试只按一次回车。是的,换行要按两次回车

下面试一下斜体字。选中你输入的几个字,点击上面工具栏的斜体按钮(I),或者按快捷键ctrl+i(即italic),或者输入*斜体*,就得到斜体。工具栏按钮的用法简单,下文就不再提了。

输入**粗体**,得到粗体。快捷键是ctrl+b(即bold)。

现在,你已经可以把一篇长文的某个词瞬间全部换成粗体或斜体了。请自己思考一下该怎么做。

00:02 超级链接+电邮

输入[晴耕雨讀志](http://dapengde.com),得到带超级链接的晴耕雨讀志。快捷键ctrl+l(即link)。

输入用尖括号括起来的电子邮件地址<name@gmail.com>,得到带链接的电子邮箱 name@gmail.com

到这里为止,你已达到 Markdown 初级水平,基本够写日记了。

00:03 插图

输入![](http://upload.jianshu.io/collections/images/18/markdown-800x492.jpg),可以插入个网络图片。方括号里可以填个图片名称,不填也没关系。快捷键是ctrl+g(即graph)。

嫌图片太大?可以指定宽度或高度,只需输入:

<img src="http://upload.jianshu.io/collections/images/18/markdown-800x492.jpg" width="100">

就得到: 用width指定了宽度。当然也可以用 height 指定高度。我拍胸脯保证本文再也不会出现比这更难的代码了。事实上,这是个html语句,这已经属于 Markdown 高级用户的水平了。

00:04 引用

段落开头加上>号就是引用。每多一个>号就多一层缩进。比如输入:

>dapeng:Markdown好用。
>>路人甲:我不信。
>>>dapeng:不信你试试。

得到:

dapeng:Markdown好用。

路人甲:我不信。

dapeng:不信你试试。

00:05 代码

如果我不想让Markdown把两个*之间的文字识别成斜体呢?用前后各用一个单引号`,像这样:`*不斜体*``。这叫做代码格式。如果一段文字全都是代码格式,只要在段首加四个空格就行了。快捷键是ctrl+k`(即kode=code)。

00:06 小标题+横线

为了层次分明,文章可以加小标题,只需在前面加 # 号。几级标题就加几个#。例如输入:

# 第一章
## 第一节

得到:

第一章

第一节

加一条横线也有助于阅读,方法是隔一个空行后输入至少三个小短横---

00:07 列表

输入:

1. 2013年......
1. 2014年......
 1. 1月......
     - 1日......

得到:

  1. 2013年……
  2. 2014年……
    1. 1月……
    • 1日……

没错,编号自动递增了。注意:该有的空格不能少;行首每多个空格,就多缩进一层;带数字的列表,以1.开头即可;不带数字的,用-号开头即可。注意好好体会。

恭喜,你使用 Markdown 的水平已经到了中级!足够用啦!

00:08 平时怎么用

初体验结束,此刻你大概已经明白,使用 Markdown 其实分两步:第1步是你写出带标记的文本,第2步是用某个软件把这些标记“翻译”成看得见的格式。

第 1 步写文本,你可以写在任何地方,比如 windows 的记事本里。

第 2 步翻译格式,windows 下可以安装 MarkdownPad,Mac 下可以安装 Mou,Linux 下请DIY。跨平台的可以安装 chrome 浏览器的插件“妈的”(MaDe)。喜欢命令行的可以用 pandoc。不想安装的话,也有网络版可用。选择很多,绝大多数都是免费,他们可以把你的文本另存为带格式的 html 文件。这里推荐几个在线版的 Markdown 编辑器:

  • StackEdit:首选,亮点无数。虽然是英文界面,但支持中文字符,有工具栏,支持 Markdown 扩展语法,能处理 LaTeX 数学公式,支持表格和脚注,能插入目录,能导出 html 和 pdf。可以直接发布到 WordPress、Blogger、GitHub,可以直接跟 Dropbox、Google Drive 同步。甚至可以用 StackEdit 来写科技论文。
  • Dillinger:亮点是实时显示字数统计。英文界面,对中文字符支持有问题。直接跟 Dropbox、GitHub、Google Drive 连接,并且能导出 pdf。
  • CMD Markdown:中文界面,有工具栏,也支持LaTeX 数学公式。但是需要登录才能导出 html 文件。
  • MaHua:中文界面,无工具栏。亮点是支持 vim 快捷键。

所谓标记语言,哪里出现什么格式都是写在文本里的,这样的语言即使离开电脑用手写在纸上,别人也能看得懂格式。html 和 LaTeX 也类似,因此学会了 Markdown,再学别的标记语言就会容易很多。

图片来自网络

你会发现,大多数情况下,其实根本用不着 Word。并且,你会逐渐体会到用纯文本的好处:小巧,简洁,方便,节能,环保,低碳。

00:09

九分钟结束,你学会了吗?有人说五分钟就够了。没错,只是那样有点小紧张,还是九分钟轻松一些。

Markdown 学起来很容易,已经有很多优秀教程了(教程1教程2教程3),那么我为什么又写一个?因为我觉得它们写得不够“傻瓜”,我希望我本文能让更多懒人能立刻用上 Markdown。

九分钟学会 Markdown》上有43条评论

  1. francis

    以前也用,但是一般用内置的就可以了,格式对我的影响不是很大。话说你的字写的不错

    回复
  2. 土木坛子

    上回你写了一个三分钟学希腊语的日志,这回又来一个9分钟MARKDOWN,看来你是开快餐店的好料啊。

    回复
    1. dapeng 文章作者

      标题党,谁不会啊?说不定过几天还会写个半小时学会LaTeX。

      回复
        1. dapeng 文章作者

          那倒不是。标题党大概是博主成长的必经阶段吧。

  3. 小马过河

    我用的一款是 MarkdownPad 2 , 简称 MP,目前在windows下,用它来生成简单的html来着。这款软件(免费版)运行速度不快,但是够用。

    回复
    1. dapeng 文章作者

      装了 Markdown 插件,后台也变成了 Markdown 界面。

      回复
  4. william

    博主写的很简单明了哈,思路也很清楚。真是膜拜了。。。。。
    我也是使用md在发博客,简单易用。本来想要自己也写一个大抵的简介,推介给更多的朋友。不过看来以后可以直接推荐博主的这篇了。哈哈

    ps, 给你写的这个评论就是用md写的哦。

    回复
    1. dapeng 文章作者

      虽然markdown评论框在我博客上摆了很久,但大概你是第一个用它的。谢谢。

      回复
  5. acheng99

    一种据说是5分钟内可以学完的东东(谢益辉)
    自从开始用RStudio+knitr后,就经常性的使用Rmd了,谁让*inux下的office老是和win平台下的office兼容性不那么好呢?干脆就用最简洁的东西了

    回复
    1. dapeng 文章作者

      是的,纯文本才是王道。用记事本打不开的东西都不是好东西。

      回复
  6. Banbrick

    前段时间看过几篇Markdown的介绍,一直没有用过,可能还是太懒了,哈哈。。

    这篇教程确实足够傻瓜,非常不错!

    回复
    1. dapeng 文章作者

      那倒是。既然不常用,就说明没用,忘就忘了吧。

      回复
    1. dapeng 文章作者

      论文写不下去的时候,就去琢磨这些。可见论文是多么难写下去。

      回复
  7. 小奔

    大鹏你用knitr写动态报告么?这里有篇看起来很牛的文章,提供一套解决方案(见Resources小节上方那张图),看起来极具诱惑力。无奈我R基础太差,还不够照搬这套方案。期待你写一篇经验文章。

    用Rmarkdown + knitr的弱点是不能很好地调word格式(小结自动编号,字体,颜色等),另外有一个包叫ReporteRs,你有用过吗?我试了一下,能很好地调格式,但规则不像markdown那样简单,好像也不能像knitr那样直接调用R参数(如:r PM25Emissionppm 输出 250ppm)。有没有两全其美的解决方案?即有Rmarkdown的简单,Knitr动态连接R数据和图,以及ReporteRs的格式调整?

    回复
    1. 大鹏 文章作者

      R菜鸟入门是我用Rmardown+knitr写的,此后再也没有用过。因为实在是用不着。我现在以内容为主,工具为辅,与其费工夫选择合适的工具,还不如把时间花在内容的书写上。我不知道有没有完美的解决方案。如果不完美的方案在流行,我认为这就说明不存在完美方案,不然的话前者不就被淘汰了吗?没有最完美的,只有最趁手的。要想工具趁手,最好的办法是自己造工具,当然,那需要时间。

      回复
  8. xacorinlab

    ~~删除线~~难道不是通用语法么,Mou里能用,Macdown不能用

    回复
        1. 大鹏 文章作者

          别的也可以。markdown是可以兼容html语法的。

  9. Jenny

    啥?

    这竟然是一个markdown的评论框

    博主厉害
    可是,基本的macdown操作我早已熟练,但不知为何 写出来的东西就是那么丑。。。没有别的博客好看,我在想,是否是因为还有其他高级操作呢?

    回复
    1. 大鹏 文章作者

      如果基本的操作导致东西比较丑,那么可能是博客的样式问题。不过,内涵比外表更重要哦。

      回复
    1. 大鹏 文章作者

      不错,谢谢分享。但是,自从用了stackedit,一旦拥有,别无所求。

      回复
    1. 大鹏 文章作者

      您好。截图需要先保存为本地图片。插入本地图片的话,![](本地路径)

      回复

发表评论

电子邮件地址不会被公开。 必填项已用*标注

To create code blocks or other preformatted text, indent by four spaces:

    This will be displayed in a monospaced font. The first four 
    spaces will be stripped off, but all other whitespace
    will be preserved.
    
    Markdown is turned off in code blocks:
     [This is not a link](http://example.com)

To create not a block, but an inline code span, use backticks:

Here is some inline `code`.

For more help see http://daringfireball.net/projects/markdown/syntax