什么是 Markdown ?

Markdown 是一种标记语言，在撰写文本时插入符号，即可生成相应格式的文档。

符号与格式间的对应关系，是提前约定好的，而且简明、易记，从而将很多工作从“写作”中抽离出去。

Markdown 文档的后缀名为：.md

为什么要用 Markdown 写作 ?

大多数人首先接触到的文档编辑器，都是 Word，Word 无论怎样改版，缺点永远罄竹难书。

  • 写文档的时候，总是会被各种符号和功能打扰，惹人烦闷的页边距、拼写更正、自动格式，无时无刻不在分散着你的注意力；
  • 写完之后，为了让文章再漂亮一些，还要花费大量时间去排版，很多功能根本不是设计给人类使用的，偶尔遇到软件崩溃，也将大大影响写作效率；
  • 修订、审阅功能，极其难用且低效。

为什么 Markdown 可以让你摆脱这些烦恼？原因就在于：它将很多工作从“写作”中抽离出去，从而让写作更加专注。

这种在功能上的分解处理，是一种被称为“解耦”的编程思想。

关于输出格式，你能想象到的所有格式的文档，Markdown 都可以转换，可以直接生成网页、PDF、epub、mobi，可以一键通过 Markdown 生成论文，并生成目录。还可以通过 CSS 自定义输出格式。

当你熟悉了 Markdown 的写作格式，直接给你一份 md 文档的原始代码，你甚至能自动脑补出格式。

怎样学习 Markdown 写作 ?

5 分钟就能学会！

必备技能清单：

  1. 如何添加链接
  2. 如何添加图片
  3. 如何添加引用
  4. 如何添加有序列表、无序列表
  5. 1-5 级标题如何编辑
  6. 如何加粗、显示斜体
  7. 如何高亮显示文字、代码
  8. 显示待办事项

在线工具（Markdown 文档实时预览）

请务必直接上手练习：

结合 Github 来写作

由于简洁和高效，甫一开始 Markdown 就受到很多社区的支持，如 Stackoverflow、Github 等代码社区，快速撰写协作文档、科技文本，并交付。

Github 能够托管你撰写的文本（代码、文字、图片等），社区成员基于此，先后开发出了 Octopress、Jekyll、Hexo 等静态网站生成工具。只要你有 Markdown 的文本，选好一个模板，外加一点个性化设置，就可以快速生成一个属于自己的博客了。

不想学习写代码，也可以通过 Github 的客户端来同步 Markdown 文档，文本的更改记录在 Github 网站上即可对比、查看。

生成 Hexo 博客教程详见：Training/How2BuildHexoBlog.md

结合 Gitbook 来写作

一句话概括：GitBook 能帮你写书。

通过 Gitbook 可以生成、编辑目录，协同编写文档，生成电子书，绑定域名后还可以在线发布。

可参考 Gitbook 入门教程

工具推荐

写作工具

其他工具

  • PopClip
    • macOS，其中有一个插件md2mm，可以将 Markdown 无序列表直接转换为 mindmap 格式
  • Pandoc
    • macOS/Windows/Linux，Markdown、Word、PDF 多种文档格式互转
  • md2googleslides
    • Generate Google Slides from Markdown
  • Markdown Here
    • Chrome、Safari 等浏览器插件，用 Markdown 格式撰写，一键转格式（CSS 格式可自定义）
  • Scrivener
    • macOS/Windows/iOS，书籍、论文、剧本等专业写作工具
  • MultiMarkdown
    • Markdown 进阶版，支持公式、脚注、引用等高级格式
  • Copy as Markdown
    • Chrome 插件，点击即可将当前网页的标题和链接以 Markdown 格式输出

练习题

点击链接：测试题

参考资料

CHANGELOG

  • 20170210 Arlmy 创建
  • 20170211 Arlmy 写作完成
  • 20170309 Arlmy 增补