标签归档:Markdown

为什么打字青年都应该用Markdown来写作?

你本不需要知道神马是Markdown。但是你发表过人人日志、博客文章吗?你偶尔写文字随笔吗?或者常常用Word、OneNote、UltraEdit等文本编辑软件的其中之一吗?哪怕有一种,你都极有可能和我一样对它相见恨晚。

首先上图!左边是实际的文本,后边是其效果。

简单说,Markdown只是用于纯文本的一种符号规则。它让大家把常见的几种格式简单直观地表现在一个TXT文档中。比如,当我们在一篇Word文档中文思泉涌之时,非常讨厌拿起鼠标这个动作,不管是设置标题,还是加粗。而在这种规则下,标题就可以简单记作:

#这是标题#

而加粗可以毫不犹豫的打字如下:

**被加粗的文字**

借助这样的规则,是不是打字快多啦?并且效果不打折?

写作和编辑文本的困难

在WEB 2.0时代,我们写作时常常遇到思维速度与必要样式的矛盾(特别是电子邮件、日记、读书笔记等场合)。我们在很多工具中徘徊,比如我常用的文档和工具有:

  • .doc Word
  • .one OneNote
  • .txt 记事本和他的兄弟们(Outlook便签、黑莓Memopad、打字利器WriteMonkey、代码利器UltraEdit等)

他们都有以下困难的一种或几种:

  1. 为了必要的格式,影响了写作速度
  2. 没有统一的纯文本标记规范
  3. 不利于批量编辑、长期积累和协作

速度与格式的完美折衷:Markdown的定位和特性

  1. 纯文本,够快
  2. 有格式,够用
  3. 易学易用,过目不忘

如果把Word等编辑器归类到“强调功能”的集合,把纯文本归类到“强调速度”的集合,那么Markdown其实就是两个集合的交集,是一种妥协,一种折衷。

五分钟速成:Markdown入门

限时5分钟,你一定可以学会这些规则。

段落

一个段落是由一个或多个连续的行构成,段落间靠一个或以上视觉上的空行划分。一般的段落不应该用空格或制表符缩进。

这是一个段落。它有两个句子。这是另一个段落。它也有 两个句子。

换行

在文本中输入的换行会从最终生成的结果中删除,浏览器会根据可用空间自动换行。如果想强迫换行,可以在行尾插入至少两个空格。

强调

*强调* 或者 _强调_**加重强调** 或者 __加重强调__***特别强调*** 或者 ___特别强调___

效果如下:

强调 或者 强调加重强调 或者 加重强调特别强调 或者 特别强调

标题

可以在标题内容前输入特定数量的井号(‘#’)来实现对应级别的HTML样式的标题(HTML提供六级标题)。例如:

# 一级标题(例)#### 四级标题(例)

效果如下:

一级标题(例)

四级标题(例)

当然,一级和二级标题还有一种写法:

一级标题===================二级标题--------------------

列表

* 无序(没有编号的)列表中的一项      * 一个子项,要以一个制表符或者4个空格缩进* 无序列表中的另一个项

效果如下:

  • 无序(没有编号的)列表中的一项
    • 一个子项,要以一个制表符或者4个空格缩进
  • 无序列表中的另一个项

接下来是有序列表。

1. 有序(排好序,有编号的)列表中的一项2. 有序列表中的另一个项

效果如下:

  1. 有序(排好序,有编号的)列表中的一项
  2. 有序列表中的另一个项

代码

要在Markdown中插入代码,你有两种选择。 当你只需要一小段代码,就把代码用反引号(`)(键盘上Esc键下面的键)包起,例如:

夹杂着`一些代码`的文字内容

效果如下:

夹杂着一些代码的文字内容

当你有超过一行的代码,就把行用制表符或至少四个空格缩进,例如:

第一行代码第二行代码第三行代码

后面一种用法会让Markdown保留所有的空白字符——而与之相反,一般情况下,Markdown会删除所有换行和空格,打乱原有的缩进和排版。

断行

如果你真的想在Markdown中插入换行标签,你可以在行尾输入两个或以上的空格,然后回车。这样插入换行十分麻烦,所以只在你确定你需要时手动添加。

引用

引用只需要在被引用的内容段落开头加上右尖括号(‘>’)即可。你可以选择只在开头加一个。也可以在每行前面都加一个,效果是一样的。

> 这一整段的内容都会作为一个HTML的引用元素。引用元素是会自动优化排版的(reflowable,可回流)。你可以任意地将引用的内容包含进来,然后所有这些都会被解析成为单独一个引用元素。

上述内容会转换成以下HTML内容:

这一整段的内容都会作为一个HTML的引用元素。引用元素是会自动优化排版的(reflowable,可回流)。你可以任意地将引用的内容包含进来,然后所有这些都会被解析成为单独一个引用元素。

引用可以嵌套。如果要在一个引用里插入一个引用,可以用两个(‘>’)开头。依此类推,根据嵌套层次加相应数量的符号。

> 这是一个引用。这是第一行

> 这是第二行。
>> 这是一个嵌套的引用。这是第一行。

>> 这是第二行

> 外层引用的第三行。

效果如下:

这是一个引用。这是第一行
这是第二行。
这是一个嵌套的引用。这是第一行。
这是第二行

外层引用的第三行。

前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的(‘>’)可以有可以没有。

链接

链接可以在行内插入,格式是:[链接文字](链接地址)

比如:[Markdown-Wiki](http://zh.wikipedia.com/wiki/Markdown)

另一种选择是,链接地址可以放在段落后面的脚注,前面放上链接引用标签区分。举例说,先在内容行内插入以下内容:[链接文字][链接引用标签],然后在段落的后面(或者文档的结尾)放上以下内容,就可以生成一个链接:

[链接引用标签]: 链接地址 "链接标题"

水平分割线

要生成水平分割线,可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条水平分割线。

* * *
***
*****
- - -
---------------------------------------

还需要下载软件吗?

不需要。用你手头的文本工具,无论是记事本、手机的备忘录、UltraEdit,还是Word、Pages,只要保存成纯文本(.txt)即可。

如何预览效果/导出成HTML?

有很多免费小软件,比如MarkdownPad
也有很多博客、论坛支持,如点点网

对我有用吗?Markdown适用的人群

  • 普通青年:日志、日记……用最快的方法来书写,用最通用的格式来保存。
  • 文艺青年:博文、图书……已经格式化的文本,可以借助免费工具快速转化为美丽的HTML和出版物,助你聚沙成塔,集腋成裘。
  • 科技青年:逻辑表达、专业文献……写作、编辑阶段的必备神器。还想要快速输入复杂公式和图表?请参考理工男专用解决方案(文艺青年止步):《为什么Markdown+R有较可能率成为科技写作主流?》
  • 2B青年:追求速度和性能的极致。比如我曾经花费无数时间来定义自己的“TXT文本格式规范”,现在后悔自己应该先百度一下啊。

不论如何,只用键盘来写文字是一件很爽快的事!

参考来源

  1. 想要快速上手,请参阅:维基百科-Markdown
  2. 完整中文语法说明,请参阅:《Markdown 语法说明 (简体中文版) 》
  3. 还不够简单?请参考博客短文:《为什么作家应该用 Markdown 保存自己的文稿》