# Markdown

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> 配置：  `设置 | 语言 & 框架 | Markdown`
>
>
>
> 文件名称模式：  `*.md`  和  `*.markdown`

[Markdown](https://daringfireball.net/projects/markdown/) 是一种轻量级标记语言，用于在纯文本中添加格式元素。 IntelliJ IDEA 可识别 Markdown 文件，并提供具备高亮显示、补全和格式设置功能的专用编辑器。 支持基于 [CommonMark 规范](https://commonmark.org/)。

Procedure: 启用 Markdown 插件

此功能依赖于 [Markdown](https://plugins.jetbrains.com/plugin/7793-markdown) 插件，该插件默认情况下在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Markdown  插件并点击   启用  。

Procedure: 创建新的 Markdown 文件

默认情况下，IntelliJ IDEA 会将任何带有  `.md`  或  `.markdown`  扩展名的文件识别为 Markdown 文件。

1. 右键点击   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中的目录，然后选择  `新建 | 文件` 。

或者，可以选择所需目录，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后选择   文件  。

2. 请为您的文件输入一个带有明确扩展名的名称，例如：  `readme.md` 。

Markdown 编辑器在您选择文本片段时，会在 [浮动工具栏](#floating-toolbar) 中提供几项基本的格式操作。 您可以使用 [预览窗格](#preview)查看渲染后的 HTML。

![Markdown 编辑器格式工具栏](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-basics.png)

在当前 project 中也有针对文件链接的 [代码补全](auto-completing-code.html)，例如，如果您需要引用源代码、图像或其他 Markdown 文件。 更多信息请参阅 [链接](#links)。

![Markdown 编辑器补全弹窗](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-completion.png)

## Markdown 格式设置

### 浮动工具栏

当您在 Markdown 文件中选择一些文本时，IntelliJ IDEA 会显示一个带有各种格式选项的浮动工具栏。

![Markdown浮动工具栏](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-floating-toolbar.png) 在普通文本和从  `H1`  到  `H6`  的标题级别之间进行选择。

* ![粗体](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.Bold.svg) 粗体 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+B` (Emacs), `Ctrl+B` (Sublime Text), `⌘ B` (Sublime Text (macOS)), `Ctrl+B` (Visual Studio), `⌘ B` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `Ctrl+B` (Eclipse), `⌘ B` (Eclipse (macOS))

* ![斜体](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.Italic.svg) 斜体 `Ctrl+I` (Windows), `⌘ I` (macOS), `⌘ I` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+I` (XWin), `Ctrl+I` (GNOME), `Ctrl+I` (KDE), `Ctrl+I` (Emacs), `Ctrl+I` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Ctrl+I` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+I` (Eclipse), `⌘ I` (Eclipse (macOS))

* ![删除线](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.Strike_through.svg) 删除线 `Ctrl+Shift+S` (Windows), `⌘ ⇧ S` (macOS), `⌘ ⇧ S` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ S` (macOS System Shortcuts), `Ctrl+Shift+S` (XWin), `Ctrl+Shift+S` (GNOME), `Ctrl+Shift+S` (KDE), `Ctrl+Shift+S` (Emacs), `Ctrl+Shift+S` (Sublime Text), `⌘ ⇧ S` (Sublime Text (macOS)), `Ctrl+Shift+S` (Visual Studio), `⌘ ⇧ S` (Visual Studio (macOS)), `Ctrl+Shift+S` (NetBeans), `Ctrl+Shift+S` (Eclipse), `⌘ ⇧ S` (Eclipse (macOS))

* ![代码](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.Code_span.svg) 代码 `Ctrl+Shift+C` (Windows), `⌘ ⇧ C` (macOS), `⌘ ⇧ C` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ C` (macOS System Shortcuts), `Ctrl+Shift+C` (XWin), `Ctrl+Shift+C` (GNOME), `Ctrl+Shift+C` (KDE), `Ctrl+Shift+C` (Emacs), `Ctrl+Shift+C` (Sublime Text), `⌘ ⇧ C` (Sublime Text (macOS)), `Ctrl+Shift+C` (Visual Studio), `⌘ ⇧ C` (Visual Studio (macOS)), `Ctrl+Shift+C` (NetBeans), `Ctrl+Shift+C` (Eclipse), `⌘ ⇧ C` (Eclipse (macOS))

* ![创建链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.Link.svg) 创建链接 `Ctrl+Shift+U` (Windows), `⌘ ⇧ U` (macOS), `⌘ ⇧ U` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ U` (macOS System Shortcuts), `Ctrl+Shift+U` (XWin), `Ctrl+Shift+U` (GNOME), `Ctrl+Shift+U` (KDE), `Ctrl+Shift+U` (Emacs), `Ctrl+Shift+U` (Sublime Text), `⌘ ⇧ U` (Sublime Text (macOS)), `Ctrl+Shift+U` (Visual Studio), `⌘ ⇧ U` (Visual Studio (macOS)), `Ctrl+Shift+U` (NetBeans), `Ctrl+Shift+U` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))

* ![无序列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.bulletList.svg) 无序列表

* ![有序列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.numberedList.svg) 有序列表

* ![勾选列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.checkmarkList.svg) 勾选列表

Procedure: 自定义浮动工具栏

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 菜单和工具栏` 。

2. 在   Markdown 编辑器浮动式工具栏  下添加或删除必要的操作。

有关更多信息，请参见 [菜单和工具栏](customize-actions-menus-and-toolbars.html)。

3. 点击   OK   以应用更改。

Procedure: 隐藏浮动工具栏

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `高级设置` 。

2. 选择   隐藏浮动式工具栏   在   Markdown   下。

3. 点击   OK   以应用更改。

### 链接

您可以使用以下语法定义链接：

```PLAINTEXT
[link-text](link-url "optional-title")

```

![在 Markdown 文件中插入链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-link-inserted.png)

Procedure: 插入链接

* 按下 `Ctrl+Shift+U` (Windows), `⌘ ⇧ U` (macOS), `⌘ ⇧ U` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ U` (macOS System Shortcuts), `Ctrl+Shift+U` (XWin), `Ctrl+Shift+U` (GNOME), `Ctrl+Shift+U` (KDE), `Ctrl+Shift+U` (Emacs), `Ctrl+Shift+U` (Sublime Text), `⌘ ⇧ U` (Sublime Text (macOS)), `Ctrl+Shift+U` (Visual Studio), `⌘ ⇧ U` (Visual Studio (macOS)), `Ctrl+Shift+U` (NetBeans), `Ctrl+Shift+U` (Eclipse), `⌘ ⇧ U` (Eclipse (macOS))。

或者，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 打开   插入…   弹出窗口，然后选择   链接  。

![在 Markdown 文件中插入链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-insert-link.png)

如果已高亮显示一些文本，它将作为链接文本包含在  `[ ]`  中。 如果您已将 URL 复制到剪贴板，它将作为链接 URL 包含在  `( )`  中。

当您将鼠标悬停在链接上时，会出现可选标题。

> **Tip:**
> 可以通过将图像和文件拖到编辑器来插入指向它们的链接。 请确保在  `设置 | 编辑器 | 常规 | 智能键 | Markdown`  中启用了   拖放时插入指向图像或文件的链接  。

Procedure: 链接到其他文件和标题

* 除了 URL，您可以添加链接到当前文件中的任何标题：

```PLAINTEXT
# This is a chapter

Link to [this chapter](#this-is-a-chapter)

```

* 您还可以链接到相对于当前文件的任何其他文件：

```PLAINTEXT
# This is a chapter

Link to [a chapter in another file](another-file.md#some-chapter)

```

IntelliJ IDEA 提供当前上下文中可用的链接标签的补全：相对于当前文件的文件和有效的标题标签。

在链接标签上 `Ctrl+Click` (Windows), `Ctrl+Click` (macOS), `Ctrl+Click` (IntelliJ IDEA Classic (macOS)), `Ctrl+Click` (macOS System Shortcuts), `Ctrl+Click` (XWin), `Ctrl+Click` (GNOME), `Ctrl+Click` (KDE), `Ctrl+Click` (Emacs), `Ctrl+Click` (Sublime Text), `Ctrl+Click` (Sublime Text (macOS)), `Ctrl+Click` (Visual Studio), `Ctrl+Click` (Visual Studio (macOS)), `Ctrl+Click` (NetBeans), `Ctrl+Click` (Eclipse), `Ctrl+Click` (Eclipse (macOS))以导航到引用的标头。

您可以在标题或标签上调用   [查找用法](find-highlight-usages.html)   `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (NetBeans), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS)) 以查看所有指向该标签的链接。 您还可以对标题或标签调用   [重命名](rename-refactorings.html)  重构 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))，以便与所有相关用法一起重命名。

### 镜像

默认情况下，Markdown 使用以下语法来插入图像，您可以在 project 内通过路径完成自行输入：

```PLAINTEXT
![alt-text](path/to/file.png "optional-title")

```

![在 Markdown 文档中插入的图片](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-image-inserted.png)

Procedure: 插入图像

1. 按下 `Ctrl+U` (Windows), `⌘ U` (macOS), `⌘ U` (IntelliJ IDEA Classic (macOS)), `⌘ U` (macOS System Shortcuts), `Ctrl+U` (XWin), `Ctrl+U` (GNOME), `Ctrl+U` (KDE), `Ctrl+U` (Emacs), `Ctrl+U` (Sublime Text), `⌘ U` (Sublime Text (macOS)), `Ctrl+U` (Visual Studio), `⌘ U` (Visual Studio (macOS)), `Ctrl+U` (NetBeans), `Ctrl+U` (Eclipse), `⌘ U` (Eclipse (macOS))。

或者，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 打开   插入…   弹出窗口，然后选择   图像  。

![在 Markdown 文件中插入图像](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-insert-image.png)

2. 在   插入图像   对话框中指定图像的路径，然后点击   OK  。

![Markdown 插入图片对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-insert-image-dialog.png)

> **Tip:**
> 可以通过将图像和文件拖到编辑器来插入指向它们的链接。 请确保在  `设置 | 编辑器 | 常规 | 智能键 | Markdown`  中启用了   拖放时插入指向图像或文件的链接  。

要配置图像，请在插入该图像的行的装订区域中点击 ![配置图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.imageGutter.svg)。 例如，您可以在   转换为 HTML   和   插入图像   对话框中选择   配置图像  ，将带有原始 HTML 标记的图像插入 Markdown 文件。

![使用原始 HTML 插入图片](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-insert-image-html.png)

这将产生以下结果：

![以原始 HTML 插入的图像](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-image-inserted-as-html.png)

### 列表

Markdown 支持  `-` 、  `*,`  和  `+`  后跟一个 Space 来表示无序列表，以及一个数字后跟句点（  `1.` 、  `2.` 、  `3.` ）来表示有序列表。 对于带复选框的任务列表，可以使用  `- [x]` 。 要轻松进行格式设置，请使用 [浮动工具栏](#floating-toolbar)。

![Markdown 文件中显示的不同类型列表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown_lists.png)

IDE 会在输入时自动调整列表中的缩进，以匹配层次结构。 可以在设置中禁用此行为：按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，选择  `编辑器 | 常规 | 智能键 | Markdown` ，然后禁用   输入时调整缩进  。

Procedure: 配置列表中的编号

可以控制 IntelliJ IDEA 对有序列表编号的方式。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 常规 | 智能键 | Markdown` 。

2. 在   列表   部分中，启用   输入时对列表重新编号  。

IntelliJ IDEA 会在输入时自动调整有序列表的编号。

3. 此外，从   列表编号   下拉菜单中选择编号样式：

* 按顺序 ：对每个列表项连续编号（ `1.` 、 `2.` 、 `3.` ）。 该选项会使 Markdown 源代码编号与渲染后的列表保持一致，从而在阅读源代码时立即明确项的位置。

* 使用 '1.' ：将每个新项写作 `1.` 。 该选项会让 Markdown 渲染器处理编号，使插入、移除或重新排序项变得简单，无需手动重新为列表编号。

* 使用之前的数字 ：为每个新项重复使用前一项的编号（例如 `5.` 、 `5.` 、 `5.` ）。 该选项便于编辑和重新排序，并保留列表现有的起始编号。

### 表

IntelliJ IDEA 提供对在 Markdown 中创建和编辑表格的支持。

Procedure: 插入表格

1. 按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 打开   插入…   弹出窗口，并选择   表  。

![在 Markdown 文件中插入表格](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-insert-table.png)

2. 选择表格的大小（行数和列数）。

3. 请输入每个单元格的内容并按 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))键将插入点从一个单元格移动到下一个。 要添加新行，请按 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS))。 当您输入时，IntelliJ IDEA 会自动调整行和列，以适应表格单元格中的内容。

有关在编辑表格时禁用辅助功能的信息，请参阅 [智能按键：Markdown](settings-smart-keys-markdown.html)。

IntelliJ IDEA 会高亮显示任何格式不正确的表格，并允许您修复它。 从列表中选择快速修复时，IntelliJ IDEA 会显示应用快速修复后的结果预览。

![对格式错误的表格进行 Markdown 检查](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown_table_formatting_inspection.png)

IntelliJ IDEA 会在编辑器中自动对齐表格单元格和列分隔符，而不修改表格的源文本，使表格更易于阅读。 如果要查看没有这种对齐的表格，请在  `设置 | 语言 & 框架 | Markdown`  中禁用   [视觉对齐表格单元格](markdown-reference.html#align-table-cells)  。

单元格已对齐:

```MARKDOWN
|One   |Two   |Three  |Four  |
|---   |---   |---    |---   |
|      |      |       |      |
|      |      |       |      |
|      |      |       |      |

```

单元格未对齐:

```MARKDOWN
|One   |Two   |Three  |Four  |
|---|---|---|---|
|   |   |   |   |
|   |   |   |   |
|   |   |   |   |
                
```

默认情况下，IntelliJ IDEA 在编辑器中显示表格列和行标记。 使用这些标记来选择、移动、插入、移除和对齐列和行。 标记是特定于 Markdown 文件的 [内嵌提示](inlay-hints.html)的一种特殊类型。 如果未看到这些标记，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开 IDE 设置，转到  `编辑器 | 内嵌提示` ，并勾选  `其他 | Markdown | 表内嵌显示`  选项。

![在 Markdown 文件中编辑表格](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-tables.png)

点击列标记执行以下操作：

* ![“向左移动列”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.back.svg) 左移列

* !["右移列按钮"](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.forward.svg) 右移列

* ![“在左侧插入列”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.addColumnLeft.svg) 插入左侧列

* ![插入右侧列按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.addColumnRight.svg) 插入右侧列

* ![选择列单元格按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.inSelection.svg) 选择列单元格

* ![左对齐按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.leftAlign.svg) 左对齐

* ![居中对齐按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.centerAlign.svg) 居中对齐

* ![右对齐按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.rightAlign.svg) 右对齐

* ![删除列按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.gc.svg) 移除列

点击行标记执行以下操作：

* ![“上移行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.up.svg) 上移行

* ![向下移动行按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.down.svg) 下移行

* ![插入上方行按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.addRowAbove.svg) 在上方插入行

* ![“在下方插入行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown.icons.editor_actions.addRowBelow.svg) 在下方插入行

* ![“选择行”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.inSelection.svg) 选择行

* ![删除行按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.gc.svg) 移除行

### 代码块

要插入一个围栏代码块，请在代码块前后使用三个反引号  ````` 。 如果您指定代码块的语言，Markdown 编辑器会默认 [注入相应的语言](using-language-injections.html)。

这将启用指定语言的语法高亮和其他编码辅助功能： [completion](auto-completing-code.html)、 [inspections](code-inspection.html) 和 [intention actions](intention-actions.html)。

![在 Markdown 中插入一个围栏代码块](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-code-blocks.png)

Procedure: 在代码块中禁用编码辅助

如果您的代码块不需要语法正确，您可能希望禁用代码注入和代码块中的语法错误。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言 & 框架 | Markdown` 。

2. 清除以下选项：

* inject 语言到代码区块中

* 在代码围栏中显示错误

3. 点击   OK  以应用更改。

Procedure: 从 Markdown 文件运行命令

当您克隆一个项目时，通常会有一个  `README.md` 文件，其中包含运行应用程序、配置环境等的说明和命令。 IntelliJ IDEA 会检测这些命令并提供运行这些命令的边距图标。

* 请点击相应的边栏图标或在光标位于您要运行的命令处时按 `Ctrl+Shift+F10` (Windows), `⌃ ⇧ R` (macOS), `⌃ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ R` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `Ctrl+Shift+F10` (Sublime Text (macOS)), `Ctrl+Alt+F5` (Visual Studio), `⌃ ⌥ F5` (Visual Studio (macOS)), `Alt+Shift+F6` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌃ ⇧ R` (Eclipse (macOS))。

运行命令时，可以 [选择用作工作目录的目录](markdown-reference.html#run-commands-from)：父文件目录或项目目录。

![在 Markdown 文件中检测到的用于运行命令的装订区域图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-run-code-block-gutter-icon.png)

您可以在 IDE 设置 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 中禁用 Markdown 文件中运行命令的边框图标  `语言 & 框架 | Markdown` ：取消选中   检测可直接从 Markdown 文件中运行的命令   复选框。

有关更多信息，请参见 [Markdown 语言设置](markdown-reference.html)。

### 数学表达式

Markdown 插件支持使用 TeX 和 LaTeX 语法向文档添加数学公式。 使用单个美元符号  `$...$`  表示内嵌数学公式，使用双美元符号  `$$...$$`  表示数学块。

![Markdown 中的数学表达式](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown_math.png) 如果您想插入字面意义上的美元符号，请使用反斜杠对其进行转义：  `\$`  或  `\$$` 。

### 图

Markdown 编辑器可以渲染用 [Mermaid](https://mermaid-js.github.io/) 和 [PlantUML](https://plantuml.com) 定义的图表。 默认情况下这是禁用的，需要额外的步骤。

![Markdown 中的 Mermaid 图表](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-diagrams-mermaid.png)

Procedure: 启用 Mermaid 图表支持

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 请查找并安装 [Mermaid](https://plugins.jetbrains.com/plugin/20146-mermaid) 插件。

Procedure: 启用 PlantUML 图表支持

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言 & 框架 | Markdown` 。

2. 安装并启用   PlantUML   在   Markdown 扩展程序或功能模块   下。

3. 在 IntelliJ IDEA 下载相关扩展后，点击   OK  应用更改。

### 目录

IntelliJ IDEA 允许根据文档中的标题生成目录。

Procedure: 生成目录

您可以生成当前文件中可用的标题列表，并使其适当缩进。

1. 将文本光标置于您希望添加当前文件的目录的位置，然后按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 打开   插入…   弹出窗口。

2. 选择   目录  。

![在 Markdown 文件中创建目录](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-table-of-contents.png)

如果您在此文件中已有目录，在添加、删除或重命名某些标题后，请选择   更新目录  进行更新。

目录内容包含在  `<!-- TOC -->` 注释标签中。

```PLAINTEXT

<!-- TOC -->
* [Main title](#main-title)
    * [Subtitle](#subtitle)
    * [Another subtitle](#another-subtitle)
* [Another main title](#another-main-title)
    * [Secondary subtitle](#secondary-subtitle)
        * [Third level header](#third-level-header)
<!-- TOC -->


```

Procedure: 从目录中省略标题

可以从目录中排除特定标题。

* 将文本光标放在要省略的标题处，按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))，然后选择   从目录中省略标题  。

IDE 会在标题前插入  `<!-- omit from toc -->` ，从而将该标题从目录中排除。

## 预览 Markdown

默认情况下，Markdown 编辑器会在 Markdown 源文件旁显示已渲染 HTML 代码的预览窗格。 您可以点击 ![编辑器按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.editorOnly.svg)   编辑器   或 ![预览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.previewOnly.svg)   预览   在 Markdown 编辑器的右上角，仅显示编辑器或预览窗格。

> **Note:**
> 预览在 [Android Studio](https://developer.android.com/studio/intro)上不起作用。 这是一个 [已知问题](https://issuetracker.google.com/issues/159933628)，有一个解决方法：使用 JetBrains 运行时而不是默认的 Android Studio 运行时。 有关更多信息，请参阅 [Fix Markdown Plugin in Android Studio](https://joachimschuster.de/posts/android-studio-fix-markdown-plugin/)。

Procedure: 水平拆分编辑器和预览

默认情况下，编辑器和预览会垂直拆分（并排显示），这对于宽屏显示器很方便。 也可以水平拆分，使预览显示在编辑器下方，这对于纵向显示器更方便。

1. 在编辑器右上角，点击 ![打开编辑器预览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.editorPreview.svg) 打开   编辑器预览   窗格。

2. 点击 ![打开编辑器预览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.editorPreviewVertical.svg) 以水平拆分编辑器和预览。

![Markdown 编辑器和实时预览窗格垂直分割](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-preview-split-horizontally.png)

要配置预览的默认布局，您可以使用   预览布局   列表在  `语言 & 框架 | Markdown`  。

Procedure: 禁用编辑器和预览滚动条同步

默认情况下，编辑器和预览窗格中的滚动条是同步的，这意味着预览窗格中的位置与源位置对应。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言 & 框架 | Markdown` 。

2. 清除   在编辑器与预览中同步滚动  。

3. 点击   OK  以应用更改。

Procedure: 更改预览字体大小

尽管您可以通过 [自定义 CSS](#css)来定义预览的字体大小，但也可以为内置样式表设置字体大小。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言 & 框架 | Markdown` 。

2. 请在   预览字体大小  字段中设置字体大小。

3. 点击   OK  以应用更改。

如果您经常需要调整预览字体大小，与其在设置中更改，不如为以下两个操作分配快捷键：   增大预览字体大小   和   减小预览字体大小  。

### 自定义 CSS

IntelliJ IDEA 提供用于在预览窗格中渲染 HTML 的默认样式表。 这些样式表旨在与默认的 [UI 主题](user-interface-themes.html)保持一致。 您可以配置特定的 CSS 规则来进行小的呈现更改：例如，更改标题的字体大小或列表中的行间距。 或者您可以提供一个全新的 CSS 来更好地匹配您的预期输出：例如，如果您想复制 [GitHub Markdown style](https://github.com/sindresorhus/github-markdown-css)。

![具有自定义 CSS 的 Markdown 预览，类似 GitHub 渲染风格](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-preview-custom-css.png)

Procedure: 配置 CSS 以渲染 HTML 预览

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `语言 & 框架 | Markdown` 。

2. 请在   自定义 CSS   下配置设置：

* 选取 加载自 以指定自定义 CSS 文件的位置。

* 选择 CSS 规则 规则以输入您想要覆盖的特定 CSS 规则。

3. 点击   OK  以应用更改。

以下是自定义 CSS 规则的示例：

```CSS
body {
    background: #DDDDDD;
    color: #888888;
    font-size: 250% !important;
}

strong { text-decoration: underline; }

```

## 重新格式化 Markdown 文件

IntelliJ IDEA 可以使用适当的换行、空行和缩进来 [重新格式化](reformat-and-rearrange-code.html) Markdown 文件。

Procedure:

您可以在 VCS 提交时、运行构建或执行其他操作时自动触发重新格式化，也可以随时手动调用它：

* 在主菜单中，转到  `代码 | 格式化代码`  或按 `Ctrl+Alt+L` (Windows), `⌘ ⌥ L` (macOS), `⌘ ⌥ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ L` (macOS System Shortcuts), `Ctrl+Alt+L` (XWin), `Ctrl+Alt+L` (GNOME), `Alt+Shift+L` (KDE), `Ctrl+Alt+L` (Emacs), `Ctrl+Alt+L` (Sublime Text), `⌘ ⌥ L` (Sublime Text (macOS)), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))。

IntelliJ IDEA 根据 Markdown 文件的 [代码样式](configuring-code-style.html)设置格式化内容。

Procedure: 配置 Markdown 代码样式设置

* 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 代码样式 | Markdown` 。

有关更多信息，请参见 [Markdown 代码样式设置](code-style-markdown.html)。

Procedure: 换行并填充段落

默认情况下，IntelliJ IDEA 不会自动对长行添加硬换行。 它将在您 [重新格式化文件](reformat-and-rearrange-code.html) 时换行。

* 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 代码样式 | Markdown` 。 配置 [Markdown 代码样式设置](code-style-markdown.html#wrapping-and-braces)以在输入时启用自动换行。

* 或者，完全禁用硬换行，以保留超过配置的最大行长度的段落。 在  `设置 | 编辑器 | 代码样式 | Markdown`  中禁用   长文本自动换行   选项。

* 您还可以使用  `编辑 | 填充段落` 操作仅在文本光标所在的段落中添加换行符。

## 导航和维护文档

Procedure: 在大型 Markdown 文件中导航

* 使用   结构   工具窗口 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS)) 或   文件结构   弹出窗口 `Ctrl+F12` (Windows), `⌘ F12` (macOS), `⌘ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ 7` (macOS System Shortcuts), `Ctrl+F12` (XWin), `Ctrl+F12` (GNOME), `Ctrl+0` (KDE), `Ctrl+F12` (Emacs), `Ctrl+R` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `Alt+\` (Visual Studio), `⌥ \` (Visual Studio (macOS)), `Ctrl+F12` (NetBeans), `Ctrl+F3` (Eclipse), `⌘ O` (Eclipse (macOS)) 来查看并跳转到相关的标题。

Procedure: 向 Markdown 文件添加注释

Markdown 没有专门的语法来注释掉行。 但是，可以使用没有地址的链接标签来模拟注释行，如下所示：

```PLAINTEXT

[//]: # (Your comment text)

```

> **Note:**
> 链接标签前必须有一个空行。

请将文本光标放在您想要注释掉的行上，然后按 `Ctrl+/` (Windows), `⌘ /` (macOS), `⌘ /` (IntelliJ IDEA Classic (macOS)), `⌘ /` (macOS System Shortcuts), `Ctrl+/` (XWin), `Ctrl+/` (GNOME), `Ctrl+/` (KDE), `Alt+;` (Emacs), `Ctrl+/` (Sublime Text), `⌘ /` (Sublime Text (macOS)), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS))。

这将添加一个带有括号内注释文本的链接标签，并在必要时在其前面添加一个空行。 按相同的快捷键取消注释。

Procedure: 自定义 Markdown 的高亮显示

IntelliJ IDEA 会根据 [配色方案](configuring-colors-and-fonts.html) 设置高亮显示各种 Markdown 元素。

1. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择   编辑器 | 配色方案 | Markdown  。

2. 选择颜色方案，接受从默认值继承的高亮设置，或按照 [颜色与字体](configuring-colors-and-fonts.html)中的描述进行自定义。

## 转换 Markdown 文件

Markdown 插件可以直接将您的 Markdown 文件导出为 HTML 和 PDF。 如果您配置 [Pandoc](https://pandoc.org/)，它也能够导出到 Microsoft Word 文件（DOCX）并从中导入。

Procedure: 配置 Pandoc

IntelliJ IDEA 应该能够自动检测到您的 Pandoc 安装。 如果不是，请执行以下操作：

1. 在主菜单中，前往  `工具 | Markdown | 配置 Pandoc…` 。

2. 在   Pandoc 设置   下，指定 Pandoc 可执行文件的位置以及您希望存储从 Microsoft Word 文档导入的图像的位置。

3. 点击   OK  以应用更改。

Procedure: 从 Microsoft Word 导入

1. 在主菜单中，前往  `工具 | Markdown | 导入 Word 文档…` 。

2. 请指定文档的位置。

Procedure: 导出 Markdown 文件为其他格式

IntelliJ IDEA 可以导出到 Microsoft Word（ [需要 Pandoc](#configure-pandoc)）、PDF 和 HTML。

1. 请点击 ![编辑器和预览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.editorPreview.svg)   编辑器和预览   或 ![预览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.previewOnly.svg)   预览   以在编辑器中显示 [HTML 预览窗格](#preview)。

> **Note:**
> IntelliJ IDEA 依赖于渲染的 HTML 将 Markdown 导出到其他格式，因此没有预览窗格时，所有导出选项将被禁用。

2. 在主菜单中，前往  `工具 | Markdown | 导出 Markdown 文件到…` 。

3. 在   导出 Markdown  对话框中，指定输出文件的名称、位置和格式，然后点击   OK  。

![Markdown 导出对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/markdown-export.png)

## See also

### 参考

[Markdown 语言设置](markdown-reference.html) [Markdown 代码样式设置](code-style-markdown.html) [智能键设置：Markdown](settings-smart-keys-markdown.html)

### 外部链接

[Canonical Markdown syntax description](https://daringfireball.net/projects/markdown/syntax) [CommonMark specification](https://commonmark.org/)

