Markdown 完全指南:轻量级标记语言

  • 它于 2004 年出现,是一种简单易读的 HTML 替代方案,用于编写网页内容。
  • 它允许您使用最少的符号语法将纯文本转换为格式化文档。
  • 它有各种扩展或变体,例如 GitHub Flavored Markdown,以扩展其功能。
  • 由于其兼容性和持久性,它是程序员、作家和学者的首选工具。

Markdown 标记语言

如果你创作网络内容,很可能遇到过以 .md 结尾的文件。如果你不知道它们是什么,也不用担心,它其实是一种写作格式,可以让你无需处理复杂的代码或使用笨重的文字处理软件就能格式化文本。它是一款旨在让写作更流畅、最终呈现专业效果的工具。

本质上,它是一个使用简单符号来指示文本是否应该加粗、作为标题还是列表的系统。与编程语言不同,它没有变量或数学计算;它只是一层视觉规则,软件会将这些规则转换成 HTML,以便世界上任何浏览器都能正确显示。

Markdown 的起源和理念

Markdown的起源

这套系统诞生于2004年左右,是John Gruber和Aaron Swartz合作的成果。其理念是打破HTML的入门门槛;在HTML中,要使一个单词加粗,你需要编写类似这样的标签: <strong>在这种语言中,几个星号就足够了。它们是基于…… 电子邮件惯例 当时,任何人,无论是否具备技术知识,都可以写出有风格的文字。

.md 文件
相关文章:
.md 文件:您需要了解的有关它们的所有信息

这种理念基于三大支柱:即时性、兼容性和持久性。其目标是让作者能够不受干扰地写作,确保文件以纯文本形式在任何设备上都能打开,并且即使处理文件的软件消失,内容也能在数十年后仍然可读。

基本语法:如何格式化文本

Markdown语法

要开始写作,首先要掌握的是标题的创建方法。标题的创建方式是在行首添加井号 (#)。井号越多,标题就越小,最多可以有六级。虽然也可以在文本下方使用连字符或等号来创建主标题,但井号仍然是目前最常用的方法。

至于强调,这很简单。如果想让文字显示为斜体,只需用一个星号或下划线将其括起来。如果想让粗体文字更有冲击力,可以使用两个星号或两个下划线。如果出现拼写错误,需要删除某个单词,可以使用两个波浪号(~)。如果需要输入系统会识别为代码的特殊字符,只需在其前面加上反斜杠,即可按字面意思显示。

直接引用使用大于号 (>) 表示,您可以通过连续输入多个大于号将一段引用嵌套在另一个引用中。为了在视觉上分隔各个部分,您可以通过在单独的一行上输入三个或更多星号、连字符或下划线来插入水平线。

数据组织:列表、链接和图像

整理信息至关重要。对于无序列表,您可以在每行开头使用星号、加号或连字符。如果需要层级结构,只需输入数字后跟句点即可创建编号列表。有趣的是,无论您最初输入的数字是多少,软件通常都会自动更正编号。

添加超链接时,我们使用方括号表示用户看到的文本,圆括号表示URL。图片的处理方式基本相同,但会在图片开头添加一个感叹号。圆括号内的文本用作替代文本(alt文本),这对于网站的无障碍访问和搜索引擎优化至关重要。

对于具有技术背景的用户,可以使用代码块。如果要高亮显示段落中的技术术语,请使用反引号 (``)。如果需要插入较长的代码片段,请将整个代码块用三个反引号 (``) 括起来,甚至可以指定编程语言,以便编辑器应用相应的颜色高亮显示。

口味、扩展和工具

Markdown 变体

非常重要的一点是,并不存在单一的封闭标准。由于最初的规范留有一些不确定因素,因此出现了所谓的“变体”。其中最著名的是GitHub Flavored Markdown (GFM),它添加了许多非常有用的功能,例如表格,而这些功能在原始版本中是没有的。此外,还有像 CommonMark 这样的实现,旨在统一标准以避免渲染错误。

写作方面,您有很多选择。您可以使用简单的 Windows 记事本,但理想情况下,您应该使用像 Visual Studio Code、Obsidian 或 Zettlr 这样的专业编辑器。这些程序提供实时预览屏幕,让您在以纯文本格式写作的同时,就能看到最终文档的显示效果。

在学术和数据环境中,将这种语言与 R 或 Python 等编程语言结合使用非常普遍。这使得创建文本和代码共存的文档成为可能,从而促进了科学研究的可重复性,并自动生成可直接插入文章流程中的图表。

这种写作系统已成为纯文本的简洁性和网络的强大功能之间的理想桥梁,使任何人都能创建持久耐用、易于编辑且完全兼容现代数字出版标准的技术文档、博客或个人笔记。


在 Google 中将其添加为首选来源