排除干扰，专注写作——Markdown

这是「笔记和文档」系列之四

本文结构：

• 用 Markdown 写作的优势
• Markdown 语法说明
  • #1 段落、换行和符号原义
  • #2 标题
  • #3 引用
  • #4 列表
  • #5 代码展示
  • #6 分隔线
  • #7 链接
  • #8 图片
  • #9 强调
• 选择适合自己的 Markdown App
  • #1 根据系统筛选
  • #2 根据使用需要筛选
  • #3 Markdown App 简介

---

用 Markdown 写作的优势

不少人有记事和写作的习惯，这一需求有很多工具可以满足，但同时又各有利弊。

• 纸（本子）和笔最自由、最舒适，不过它容易遗失，不便于携带，翻找也比较麻烦。
• 纯文本编辑器（如 Windows 记事本）即开即写，所保存的纯文本（TXT 文件）在任何平台上都可以打开，但是它无法设置任何格式，文件管理和内容检索也是个麻烦。
• Office 软件有丰富的版面设置功能，但是每当要设置格式（比如设定小标题）就要中断写作，进行一系列点选操作。文档必须依附于庞大的 Office 软件，跨平台不能保证显示一致，并且同样存在文件管理和内容检索的麻烦。
• 直接在博客、QQ 空间等网络日志平台上写作，内容管理和备份麻烦，并且编辑器很不友好。
• 将内容存放在印象笔记（备忘录）中可以解决同步和检索的需要，只是在手机上它们只适合短小的速记，写较长的内容时同样和 Office 一样，每当要设置格式就要中断写作，进行一系列点选操作。

能不能以纯文本的方式不间断地写，最终存入印象笔记或发布到网络媒体时，又无需回头设置格式呢？有，使用 Markdown App。

Markdown App 所保存的文件（.txt、.md、markdown）仍是纯文本文件，可以轻易用各平台的纯文本编辑器打开，不存在版本兼容的问题。但是这纯文本中插入了一些符号标记，经 Markdown App 解释渲染，就可以格式分明地显示为 HTML 页面，无论是添加进印象笔记、输出为 PDF 等文档，还是打包为电子书（.epub、.mobi、.azw 等）都很方便。

Markdown 文档及预览

Markdown 标记受到比较广泛的支持，在《思维导图和大纲》中介绍的 iThoughts、Cloud Outliner Pro 可以将导图、大纲输出为 Markdown 文档或纯文本，然后在 Markdown App 中打开。从构思到写作，然后添加进印象笔记，或者发布到网络媒体，以 Markdown 为桥梁，创作者可以构建完整的创作链条。

将 Cloud Outliner Pro 中的大纲导出到 Markdown App

Markdown 语法说明

很多人看到「语法」两个字就头大，但其实 Markdown 的语法特别简单，只需对着说明文档尝试几次，就可以熟练使用。

#1 段落、换行和符号原义

1. 段落不能使用 4 个半角空格或制表符来实现首行缩进，若是喜欢首行缩进，应使用 2 个全角空格。
2. 换行：
   • 键入 2 个半角空格再回车，实现段内换行；
   • 两次回车空出一行，表示另起段。段落之间、段落与标题之间应该留一个空行。
3. 在 Markdown 语法中，一些半角符号被征用为格式标记，如果要在行文中用到符号自身，可以在符号前加上 \。要用到 \ 自身，请输入 \\。

#2 标题

标题的格式是行首 # 号+空格+标题文字，# 号从 1 个到 7 个分别指 1-7 级标题。例如：

# 一级标题

## 二级标题

###### 六级标题

上面的「#2 标题」实际是 ### \#2 标题。

#3 引用

引用的格式是行首 > 号+空格+引用文字，多个 > 号表示多层引用，引用部分仍可以使用其他的 Markdown 语法。例如：

> ### 这是第一层引用的标题
>
>> 这是嵌套引用。
>
> 返回到第一层引用。

效果如下：

这是第一层引用的标题

这是嵌套引用。

返回到第一层引用。

#4 列表

无序列表的格式是行首减号（或者星号、加号）+空格+项目文字：

- 手机
- 平板
- 电脑

效果如下：

• 手机
• 平板
• 电脑

有序列表是行首数字+英文句点+空格+项目文字：

1. 手机
2. 平板
3. 电脑

效果如下：

1. 手机
2. 平板
3. 电脑

项目间的子列表、段落、引用、代码块必须在行首添加制表符（Tab 键，4 个空格同样实现一个制表符的效果）缩进。

#5 代码展示

代码展示语法主要面向码农群体，普通写作人群很少使用。

有两种方式插入代码块，一种是在每行代码的行首添加制表符：

    <ul>
    <li><p>手机</p></li>
    <li><p>平板</p></li>
    </ul>

另一种是在代码块的前后分别加一行 ```：

```
<ul>
<li><p>手机</p></li>
<li><p>平板</p></li>
</ul>
```

在普通段落内用成对的 ` 引用代码：

`<pre>` 和 `<code>` 标签

制表符既用于表示项目下属内容（包括子列表、段落、引用等），又用于表示代码块，这可能让初学者感到困惑，这里演示解释一下：

1. 手机
    - iPhone
    - Galaxy
2. 平板  
    还是 iPad 好用。  
        Surface 算不算平板？
3. 电脑
    - 台式机
    - 笔记本

效果如下：

1. 手机

   • iPhone
   • Galaxy

2. 平板

   还是 iPad 好用。

    Surface 算不算平板？
   

3. 电脑

   • 台式机
   • 笔记本

可以看到，在一级项目后的项目或段落前仅加一个制表符时，表示的是子项目或下属段落，加两个制表符时才会变成代码块。以此类推，在二级项目后加两个制表符、三级项目后加三个制表符……都表示为项目下属内容，只有在此基础上再增加一个制表符，才会被解释为代码块。

#6 分隔线

在一行中用三个以上的星号、减号、底线来建立一个分隔线。行内不能有其他东西，但可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

* * *

***

*****

- - -

----

#7 链接

用方括号标记文字，用圆括号标记网址，例如：

[新浪](http://www.sina.com)

如果不需要标记文字，而显示为网址本身，可以使用尖括号：

<http://www.sina.com>

网址链接还有一种参考式语法，这里不再介绍。

#8 图片

与网址链接类似（前面多一个半角的感叹号）：

![MarkdownX](https://img.haomeiwen.com/i228805/3c41aa3c07154bde.png)

图片链接一样有参考式语法，这里不再介绍。

#9 强调

1. 斜体

   用成对的星号或底线包围，如：

   *斜体*
   
   _斜体_
   

2. 粗体

   每边各用两个星号或底线包围，如：

   **粗体**
   
   __粗体__
   

选择适合自己的 Markdown App

#1 根据系统筛选

我们根据自己所用的设备看看各个系统（包括 Windows、MacOS、iOS、Android，不包括 Linux）上的 Markdown App 主要有哪些。

各平台主要的 Markdown App

MacOS 和 iOS 平台上的 Markdown App 较多，除了上图列出的，还有著名的 iA Writer、Byword、Mou、Focused 等等。

#2 根据使用需要筛选

不同的用法需要 App 提供不同的功能：

• 如果把 Markdown App 当作自己的主要笔记本，则需要 App 具备文稿管理功能、支持各设备所属平台、能够方便地同步数据。
• 如果把印象笔记当作个人内容资料的最终汇集处，那么 Markdown App 须支持链接到印象笔记。此外
  • 如果只写短文，每次写完就汇入印象笔记，那么文稿管理和数据同步功能便无关紧要；
  • 如果涉及长篇写作，就需要 App 具备文稿管理和数据同步功能。

上图所列的 Simplenote、Ulysses 和 Bear 都定位为轻量的笔记服务，但我个人不推荐将基于 Markdown 的笔记服务当成个人的主要笔记本，原因如下：

• Markdown 本质上还是纯文本，只能以链接的方式插入图片，如果用户常常写照片日志，就需要申请或购买图床空间，先照片上传到图床之后，再链接到 Markdown 文本中。这样远比直接使用印象笔记麻烦。
• 同样的道理，基于 Markdown 的笔记服务不支持绘画、涂鸦，也不能添加音频等各种附件。
• 仍因受限于 Markdown，这些笔记服务的采集功能不如主流笔记应用强大，也难以转化表格等版面形式。

Markdown 使人可以专注于写，不必停下来设定格式，也不必考虑平台和软件的兼容问题，为此它舍弃了复杂的版面形式，更是不支持影音媒体文件，所以把它当作笔记服务的根基，将难以适应多样的笔记需求。

我仍然推荐使用印象笔记作为个人内容资料的最终汇集处。在需要专注地写的时候使用 Markdown App，完稿发布之后汇入印象笔记。

#3 Markdown App 简介

1. Simplenote

   Simplenote

   准确来说 Simplenote 是一个在线服务，它使用自建的数据同步机制，因而除了使用它在各平台上的客户端，还可以直接使用网页版。

   Simplenote 采用免费增值模式，免费用户也可以使用以下功能：

   • 用文件夹和标签管理内容。
   • 支持导入印象笔记等多种数据。
   • 与别的 Simplenote 用户协作，共同维护内容。
   • 自动备份，能够回溯历史版本。
   • 支持全文搜索和标签筛查。

   从主打功能可以看出，Simplenote 是更类似印象笔记的一个轻量笔记服务。

   Simplenote 支持的平台虽多，但它定位为笔记服务，内置导出功能很弱。要导出为 HTML（出成 PDF、DOC 及其他电子书格式的关键）或发布到印象笔记、网络媒体都需要“曲线救国”。

2. Yu Writer

   Yu Writer

   Windows 平台上的优秀 Markdown App 为数不多，Yu Writer 作为一款免费软件，不但极其优秀，而且漂亮得不像实力派。它的特点如下：

   • 支持 Windows、MacOS 平台；
   • 内置文档库，支持全文搜索和标签管理，亦可单纯地用作编辑器编辑本地文档；
   • 自动保存，支持版本回溯；
   • 可以把文档导出为 PDF、Docx、HTML、Text Bundle、图片等格式，还支持导出为 WordPress 或者微信公众号的文章格式；
   • 内置静态博客、ePub 电子书以及个人知识库（Wiki）生成引擎，创建、编辑、发布文章都在本应用程序内轻松方便完成。

   Yu Writer 的文稿管理和生成 eBub 电子书的功能为长篇写作而准备，然而没有内置对云同步的支持。长文写作常常需要切换设备续写，用户可以将 Yu Writer 的文档库移至 OneDrive、坚果云等网盘的同步文件夹来实现同步。

3. MarkEditor

   MarkEditor

   MarkEditor 是付费软件，和 Yu Writer 一样支持文档库、版本回溯和丰富的导出格式（PDF、HTML、长图片、电子书、Wiki 网页、微信公众号格式，相比 Yu Writer 少了 Docx），此外有一些很有特色的功能：

   • 内置对七牛、Farbox、Amazon S3 等商业云的支持，在 Windows 和 MacOS 版的 MarkEditor 间同步十分方便；
   • 商业云支持外链，因此生成的 Wiki 站点可供别人访问；
   • 可以通过拖放、复制粘贴来插入图片链接，也可以扫描二维码从手机传输和插入图片；
   • 改进表格的语法，不但可以生成普通表格，还可以根据数据生成柱状图、曲线图和饼状图。

   MarkEditor 同样为长篇写作做好了准备，但手机上并没有支持商业云同步的 Markdown App，如果常在手机上续写，还是得使用上述 OneDrive、坚果云等网盘同步的方法。此外，因为表格语法是个性设计，在其他编辑器上将无法预览。

4. Typora

   Typora

   Typora 是支持 Windows 和 MacOS 的一款免费 App，其极简的特性受到大量用户的喜爱，堪称 Windows 上最受欢迎的 Markdown App。

   Typora 最大的特点是将输入和预览合为一体，用户键入标记符号，马上可以看到最终效果。此外它有自动补完的功能，按回车键能自动补完成对出现的标记符号。

5. Ulysses

   Ulysses

   Ulysses 是屡获大奖的 Markdown 写作 App，它用经典作品《尤利西斯》命名来表明它的定位——一款专为作家设计的写作工具。

   Ulysses 以 Markdown 为基础，但又针对电脑和移动设备的操作逻辑做出各种优化。它有强大的文库管理功能，满足用户片断组合的创作方式，同时通过 iCloud（或 Dropbox）同步，使用户能在 MacOS 和 iOS 之间无缝衔接。但是因为它的文库不再存储为标准的 Markdown 格式，其他 Markdown App 已无法正常打开。

   Ulysses 实行订阅制，对笔耕不缀的写作者来说，订阅制可以确保 App 的品质，但对普通用户来说，其定价显得高了一些。

6. Bear

   Bear

   Bear 是一款新兴的 Markdown 笔记 App，凭借极其漂亮的界面和完善的笔记功能，在推出当年勇夺年度最佳 App 大奖。

   虽然 Bear 的颜值让人难以抵抗，但是作为一款笔记工具还是有许多局限：

   • 如前所述 Markdown 的局限；
   • 不支持 Windows 和 Android；
   • 同样实行订阅制，对免费用户不如印象笔记友好。

7. MWeb

   MWeb

   MWeb 堪称 Markdown App 的集大成者，它支持文库，也支持作为编辑器打开外部文件；它可以作为多种博客的发布器，也支持链接到印象笔记、Blogger、Medium 和 Tumblr；它内置图库功能，能把本地图片一键上传到Google Photos、imgur、七牛云存储和自定义图床上传服务。

   MWeb 是我在电脑上使用最频繁的 Markdown App，因为用它导出文档、发布到网络或归入印象笔记都很便捷，可惜它并不支持 Windows 和 Android 系统。

8. 1Writer

   1Writer

   作为 iOS 上一款不可忽略的 Markdown App，1Writer 在定位上更倾向于内容摘录和整理，这与上述 Markdown App 颇不相同。

   • 1Writer 支持分享面板插件，并且可以定制摘录模板，用户借此可以方便地摘抄内容、输入读感。
   • 1Writer 是在 iOS 上中罕见地支持查找替换功能的 Markdown App，用户借此功能可以对文档进行简单的快速处理。
   • 1Writer 支持 JavaScript 动作，用户可以自行编写个性的文档处理功能，比如快速选中当前行、删除多余空行等。

   如果常在网上摘抄并批注，1Writer 非常适用。

9. MarkdownX

   MarkdownX

   Android 上的 Markdown App 不多，免费 App——MarkdownX 可说是其中最优秀的一个。它支持自动保存、HTML 实时预览、导出分享、横屏双面板对照写作、文件搜索和 Dropbox 同步，可惜 Dropbox 并不存在。

---

题图来自 Ulysses 官网