在写文章时，我们经常不可避免地需要对文字添加不同的样式来使版面清晰或区别重要性：加粗表示强调，冠以引号表示引用，使用不同字号以区分标题和正文等。

熊掌记从诞生到现在，一直秉承「灵活记录，优雅写作」的理念。简洁的界面背后有着强大的功能作为支撑，其中之一便是一种纯文本标记语法—— Markdown。在熊掌记里写作，我们可以抛开大部分传统写作软件里复杂的「格式功能栏」来进行样式变换，使用 Markdown 语法可以轻松给文字添加各种不同的样式。但或许不是所有人都清楚它的含义及用法，本文即是为此而生 —— 这是一篇 Markdown 快速入门指南，后续我们还会有更多进阶指引推出。

快问快答：什么是 Markdown 语法?

Markdown 是一种通过特殊字符（如*星号、_下划线、~波浪线）向纯文本添加格式（如粗体，斜体，标题，“引用”和链接）的轻量级标记语言。轻量化体现在它易于备份和在线发布，跨平台迁移，支持转换为 PDF 和其他格式，这也适应了未来的发展趋势。

千万别被「语法」两个字吓到，它并不意味着你需要精通编程或是重新学习一门语言。使用 Markdown 语法，你只需要输入几个字符就能方便地调整文章排版。

Markdown 的另一个优点是，它在支持该格式的每个 app 中的工作方式都相同，包括 GitHub、简书、WordPress、Draft、iPhone 等平台。Markdown 文件是可迁移的，我们拿肌肉记忆来做类比：人一旦学会了骑自行车或一种乐器，并不会因为换了台车或琴就忘记这项技能，以 Markdown 语言编辑的文稿可以导出为以 .md 为后缀的文件，这种文件可以用任意一款支持 Markdown 的工具打开，只要这些工具严格遵循 Markdown 语法，显示格式就会始终保持一致。

重要说明：熊掌记当前默认使用一种与 Markdown 非常类似的 Polar 语法，同时， Markdown 兼容模式（标准 Markdown）也在偏好设置中作为一个选项出现。此外，我们正在准备一项将语法完全转换为标准 Markdown，即 CommonMark 的重要升级。如果您想快人一步，现在就将您的笔记转换为 Markdown 格式，请点击此链接以获取指引。

摆脱菜单，专注键盘

学习 Markdown 语法的另一个好处是可以省去不少在菜单中苦苦寻找的麻烦，这样一来您的双手可以始终停留在键盘上，同时完成书写和编辑格式的操作，使节奏和灵感不必被打乱。我们特意录了一段 GIF 动图，来展示使用 Markdown 写作的便利之处。在 GIF 图里你可以看到，用一个 # 加空格键，就能将文字设置为一级标题，并且这些标题文字和正文比起来有着更大的字号。

下面让我们介绍一些基础语法¹：

• 四个星号间插入文本为加粗：**加粗**
• 两个下划线间插入文本为斜体: _斜体_²
• 两个波浪线间插入文本为加下划线：~下划线~
• 四个波浪线间插入文本为加删除线：~~删除线~~
• 链接格式：[将单词或短语括在方括号内](然后将链接地址放在后面的括号中)，例如这样：少数派 [少数派](https://sspai.com) 
• 标题格式：以 # 号开头（ # 号加空格为一级标题，## 为二级标题，最高支持六级标题 ######）
• 以（*）或（-）开头为无序列表
• 以 1. 开始为排序列表
• 创建任务：在文字前插入 - [ ]（连接号和两个方括号，每个符号之间空格）

使用以上标记语法来控制文本格式的写作方式，就是 Markdown 写作。熊掌记对 Markdown 写作的支持 ，使得我们可以用 Markdown 语法书写并在熊掌记中直观呈现出想要的文字排版格式。

在 macOS 和 iOS/iPadOS 的熊掌记中，我们都可以使用 Markdown 语法写作。Mac 定位高效专业，而 iOS/iPadOS 移动设备强调便捷操作，因此熊掌记针对在两类设备中使用 Markdown 写作有着不同的优化。

🐻：尽管熊掌记默认使用的是与标准 Markdown 稍有区别的 Polar 语法，您仍然可以通过轻松几步将您的笔记转换为标准 Markdown 语法，点此获得相关步骤指引。如果您刚开始使用熊掌记，我们推荐您在偏好设置中打开 Markdown 兼容模式进行学习。

在 macOS 版熊掌记中使用 Markdown

Markdown 语法简单易学，目前，熊掌记总共支持 5 大类超过 17 项 Markdown 语法规则。如果你对 Markdown 语法还不熟悉，别担心，三条大路通罗马：

1. 点击熊掌记上方菜单栏中的「格式」按钮选择样式

2. 点击熊掌记编辑器窗口右下角的钢笔图标以显示「样式栏」，点击查看熊掌记支持的所有 Markdown 语法列表

3. 如果你的 Mac 带有「Touch Bar 触控栏」，别犹豫，直接上手点选即可

样式栏

熊掌记在「样式栏」提供的 Markdown 语法列表中显示了三类信息：

• 左侧列：Markdown 语法图标，直观显示应用该语法后文字的显示效果；
• 中间列：标记字符，即使用方式。在熊掌记中清晰易懂地展示了 Markdown 格式「所见即所得」的呈现方法；
• 右侧列：快捷键。快捷键省略了语法输入的繁复步骤，保持双手一直停留在键盘上，避免打断输入的同时也能实现相同的效果。

在写作时，大多数人最常用到的几类 Markdown 语法为：标题、粗体、链接、列表、排序列表，我们只要能记住这几类语法的标记字符或它们的快捷键，基本上就能开始畅快写作了。

✒️小技巧：熊掌记设计了一个贴心小功能——点击 Markdown 语法列表窗口右上角的图标，就能让这个窗口保持常驻显示。常驻窗口还可以被自由拖动到任意地方，你可以将它与编辑器并排显示作为参考，对于 Markdown 语法初学者来说非常有用。

🐻：如何在文章中插入图片呢？最直接的方式是将图片拖动到编辑器里（当然你也可以使用「文件」语法）。

在 iOS 和 iPadOS 版熊掌记中使用 Markdown

在 iOS 和 iPadOS 版设备中，我们依然可以使用标记字符来设置文字样式。但是移动设备的键盘只能显示有限的符号，要想输入 # 或 * 以及其他符号都较为麻烦。因此在熊掌记 iOS 和 iPadOS 版中，我们可以利用更便捷的「快捷工具栏」。

在 iOS 和 iPadOS 设备上利用熊掌记写作时，键盘上方会显示「快捷工具栏」，专门用于帮助我们在写作时快速设定文字格式。例如 H 符号对应的是设置标题、B 符号是加粗……15 种 Markdown 语法在快捷功能栏均有提供，仅需左右滑动即可点选需要的文字格式。

除此之外，iOS 和 iPadOS 版的熊掌记支持任何与 iPad 或 iPhone 兼容的外接蓝牙键盘，点此即可获得 iOS 和 iPadOS 所支持的快捷键列表。

祝你写作愉快

Markdown 语法是在熊掌记中写作的基础，它对于我们保持写作时的专注力和高效率等都大有裨益。同时，Markdown 简单易学，相信你只需要在熊掌记中简单尝试写几篇文章，就能熟练掌握这种语法规则。