Markdown入门

Markdown概述, 它是如何工作的, 以及你可以用它做什么。

MarkDown是什么？

Markdown是一种轻量级的标记语言，可用于将格式设置元素添加到纯文本文档中。Markdown 由John Gruber于2004年创建，如今已成为世界上最受欢迎的标记语言之一。

使用Markdown与使用WYSIWYG编辑器不同。在Microsoft Word之类的应用程序中，单击按钮以设置单词和短语的格式，更改立即可见。Markdown不是那样的。当您创建Markdown格式的文件时，可以在文本中添加Markdown语法，以指示哪些单词和短语看起来应该有所不同。

例如，要表示标题，请在其前面添加一个数字符号（例如# Heading One）。或将短语加粗，可在其前后添加两个星号（例如**this text is bold**）。可能需要一段时间才能习惯于在文本中看到Markdown语法，特别是如果您习惯于所见即所得的应用程序。下面的屏幕截图显示了Atom文本编辑器中显示的Markdown文件。

Atom文本编辑器中的Markdown文件

您可以使用文本编辑器应用程序将Markdown格式元素添加到纯文本文件。或者，您可以将多种Markdown应用程序之一用于macOS，Windows，Linux，iOS和Android操作系统。还有一些基于Web的应用程序专门用于Markdown编写。

根据您使用的应用程序，您可能无法实时预览格式化的文档。但这没关系。根据Gruber的说法，Markdown语法被设计为可读性强且不显眼，因此即使未呈现Markdown文件中的文本也可以读取。

Markdown格式化语法的首要设计目标是使其更具可读性。这个想法是Markdown格式的文档应该以纯文本的形式原样发布，而不会看起来像被标签或格式说明所标记。

为什么要使用Markdown？

您可能想知道为什么人们使用Markdown而不是WYSIWYG编辑器。当您可以按下界面中的按钮来设置文本格式时，为什么还要使用Markdown书写？事实证明，人们使用Markdown而不是WYSIWYG编辑器的原因有两个。

  • Markdown可以用于一切。人们使用它来创建网站，文档，便笺，书籍，演示文稿，电子邮件和技术文档。

  • Markdown是便携式的。几乎可以使用任何应用程序打开包含Markdown格式文本的文件。如果您决定不喜欢当前使用的Markdown应用程序，则可以将Markdown文件导入另一个Markdown应用程序。这与Microsoft Word等文字处理应用程序形成了鲜明的对比，Microsoft Word将文字内容锁定为专有文件格式。

  • Markdown是独立于平台的。您可以在运行任何操作系统的任何设备上创建Markdown格式的文本。

  • MarkDown是未来的证明。即使您正在使用的应用程序将来会在某个时候停止工作，您仍然可以使用文本编辑应用程序读取Markdown格式的文本。当涉及需要无限期保存的书籍，大学论文和其他里程碑文件时，这是一个重要的考虑因素。

  • Markdown无处不在。Reddit和GitHub等网站都支持Markdown，许多桌面和基于Web的应用程序都支持它。

开始尝试

Markdown入门的最佳方法是使用它。有了各种免费工具，这比以往任何时候都容易。

您甚至都不需要下载任何内容。您可以使用几种在线Markdown编辑器来尝试在Markdown中编写。Dillinger是最好的在线Markdown编辑器之一。只需打开站点并开始在左窗格中输入即可。呈现的文档的预览出现在右窗格中。

Dillinger Markdown编辑

阅读本指南时，您可能希望保持Dillinger网站的打开状态。这样，您就可以在学习语法时尝试使用它。熟悉Markdown之后，您可能想使用可以安装在台式计算机或移动设备上的Markdown应用程序。

它是如何工作的？

Dillinger使Markdown的编写变得容易，因为它隐藏了幕后发生的事情，但是值得探索该过程的总体工作方式。

在Markdown中书写时，文本存储在带有.md或.markdown扩展名的纯文本文件中。但是那又怎样呢？您的Markdown格式的文件如何转换为HTML或可打印的文档？

简短的答案是，您需要一个能够处理Markdown文件的Markdown应用程序。有许多应用程序可用—从简单脚本到类似于Microsoft Word的桌面应用程序，应有尽有。尽管它们在视觉上有所不同，但所有应用程序都执行相同的操作。像Dillinger一样，它们都将Markdown格式的文本转换为HTML，以便可以在Web浏览器中显示。

Markdown应用程序使用一种称为Markdown处理器（也通常称为“解析器”或“实现”）的东西来获取Markdown格式的文本并将其输出为HTML格式。此时，可以在Web浏览器中查看您的文档，或者将其与样式表组合并打印。您可以在下面看到此过程的直观表示。

注意： Markdown应用程序和处理器是两个单独的组件。为了简洁起见，在下图中，我将它们组合为一个元素（“ Markdown应用程序”）。
减价过程

总而言之，这是一个四部分的过程：

  1. 使用文本编辑器或专用的Markdown应用程序创建Markdown文件。该文件应带有.md或.markdown扩展名。
  2. 在Markdown应用程序中打开Markdown文件。
  3. 使用Markdown应用程序将Markdown文件转换为HTML文档。
  4. 在网络浏览器中查看HTML文件，或使用Markdown应用程序将其转换为其他文件格式，例如PDF。

从您的角度来看，该过程将根据您使用的应用程序而有所不同。例如，Dillinger本质上将第1-3步组合到一个无缝的界面中，您要做的就是在左窗格中键入内容，并且呈现的输出神奇地出现在右窗格中。但是，如果您使用其他工具（例如带有静态网站生成器的文本编辑器），则会发现该过程更为可见。

Markdown有什么用处？

Markdown是记笔记，为网站创建内容以及生成可打印文档的快速简便的方法。

学习Markdown语法并不需要很长时间，一旦您知道如何使用它，就可以在几乎所有地方使用Markdown进行编写。大多数人都使用Markdown来创建Web内容，但是Markdown可以很好地格式化从电子邮件到购物清单的所有内容。

这是您可以使用Markdown进行操作的一些示例。

网站

Markdown是为网络设计的，因此，有很多专门用于创建网站内容的应用程序不足为奇。

如果您正在寻找使用Markdown文件创建网站的最简单方法，请查看blot.im和smallvictori.es。在您注册这些服务之一之后，它们将在您的计算机上创建一个Dropbox文件夹。只需将Markdown文件拖放到该文件夹​​中，然后-po！-它们在您的网站上。再简单不过了。

如果您熟悉HTML，CSS和版本控制，请查看Jekyll，这是一个受欢迎的静态网站生成器，它使用Markdown文件并构建HTML网站。这种方法的优势之一是GitHub Pages为Jekyll生成的网站提供免费托管。如果Jekyll不是您的理想之选，请选择其他可用的静态站点生成器之一。

注意：我使用Jekyll来创建《MarkDown指南》。您可以在GitHub上查看源代码。

如果您想使用内容管理系统（CMS）来为网站提供动力，请查看Ghost。这是一个免费的开源博客平台，具有出色的Markdown编辑器。如果您是WordPress用户，您将很高兴知道WordPress.com上托管的网站有Markdown支持。自托管的WordPress网站可以使用Jetpack插件。

文件资料

Markdown没有像Microsoft Word这样的文字处理程序的所有功能，但是对于创建基本文件（如作业和字母）已经足够了。您可以使用Markdown文档创作应用程序来创建Markdown格式的文档并将其导出为PDF或HTML文件格式。PDF部分是关键，因为一旦有了PDF文档，您就可以使用它进行任何操作-打印，通过电子邮件发送或将其上传到网站。

这是我推荐的一些Markdown文档创作应用程序：

提示： iA Writer提供了用于预览，打印和导出Markdown格式的文档的模板。例如，“ Academic – MLA样式”模板使段落缩进并添加双句间距。

笔记

在几乎所有方面，Markdown都是记笔记的理想语法。不幸的是，两个最受欢迎的笔记应用程序Evernote和OneNote当前不支持Markdown。好消息是，其他一些笔记应用程序也支持Markdown：

  • Simplenote是适用于每个平台的免费的准系统笔记应用程序。
  • 值得注意的是可以在各种平台上运行的笔记应用程序。
  • 熊是适用于Mac和iOS设备的类似Evernote的应用程序。默认情况下，它并不专门使用Markdown，但是您可以启用Markdown兼容模式。
  • Boostnote自称是“专为程序员设计的开源笔记应用程序”。

如果您不能退出Evernote，请查看Evernote 的基于订阅的Markdown编辑器Marxico，或在Evernote网站上使用Markdown Here。

图书

想要自行出版小说？尝试使用Leanpub，该服务可将您的Markdown格式的文件转换为电子书。Leanpub以PDF，EPUB和MOBI文件格式输出您的图书。如果您要创建书籍的平装本，可以将PDF文件上传到Kindle Direct Publishing等其他服务。要了解有关使用Markdown编写和自行出版书籍的更多信息，请阅读此博客文章。

简报

信不信由你，您可以从Markdown格式的文件生成演示文稿。在Markdown中创建演示文稿需要一点时间来适应，但是一旦掌握了它，它比使用PowerPoint或Keynote之类的应用程序更快，更容易。Remark（GitHub项目）和Cleaver（GitHub项目）一样，是一种基于浏览器的流行Markdown幻灯片工具。如果您使用的是Mac，并且希望使用某个应用程序，请查看Deckset或Marked。

电子邮件

如果您发送大量电子邮件，并且对大多数电子邮件提供商网站上可用的格式设置控件感到厌倦，那么您将很高兴地发现有一种使用Markdown编写电子邮件的简便方法。Markdown这是一个免费的开放源代码浏览器扩展程序，可将Markdown格式的文本转换为可发送的HTML。

文献资料

Markdown非常适合技术文档。像GitHub这样的公司越来越多地转向Markdown来获取其文档-请查看其博客文章，了解如何将其Markdown格式的文档迁移到Jekyll。如果您编写产品或服务的文档，请查看以下便捷工具：

  • 阅读文档可以从您的开源Markdown文件生成文档网站。只需将您的GitHub存储库连接到他们的服务并进行推送-阅读文档即可完成其余工作。他们还为商业实体提供服务。
  • MkDocs是一种快速简单的静态站点生成器，专门用于构建项目文档。文档源文件使用Markdown编写，并使用单个YAML配置文件进行配置。MkDocs具有多个内置主题，包括与MkDocs一起使用的Read the Docs文档主题的端口。最新主题之一是MkDocs Material。
  • Docusaurus是一个静态网站生成器，专门用于创建文档网站。它支持翻译，搜索和版本控制。
  • VuePress是由Vue提供支持的静态站点生成器，并针对编写技术文档进行了优化。
  • Jekyll在网站上的该部分中前面提到过，但是它也是从Markdown文件生成文档网站的一个不错的选择。如果您走这条路，请务必查看Jekyll文档主题。

MarkDown的味道

使用Markdown的最令人困惑的方面之一是，实际上每个Markdown应用程序都实现了稍有不同的Markdown版本。Markdown的这些变体通常称为口味。掌握应用程序实现的Markdown风格是您的工作。

为了让您了解Markdown风味的概念，将其视为语言方言可能会有所帮助。华雷斯城的人说西班牙语，就像巴塞罗那的人一样，但是两个城市使用的方言之间有很大的不同。使用不同Markdown应用程序的人也是如此。使用Dillinger与Markdown写作与使用Ulysses有着截然不同的经历。

实际上，这意味着当他们说支持“ Markdown”时，您永远不会确切知道公司的意思。他们是在谈论基本语法元素，还是所有基本语法和扩展语法元素的组合，还是语法元素的任意组合？在阅读文档或开始使用该应用程序之前，您不知道。

如果您刚刚起步，我能给您的最好建议是选择一个具有良好Markdown支持的Markdown应用程序。这将对维持Markdown文件的可移植性大有帮助。您可能想要在其他应用程序中存储和使用Markdown文件，并且为此需要从提供良好支持的应用程序开始。您可以使用工具目录查找适合该账单的应用程序。

其他资源

您可以使用很多资源来学习Markdown。以下是一些其他介绍性资源：