切换到 Markdown 模式 （${ hints.mdMode }）

在代码块中禁用编码辅助

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

1. 按 Ctrl+Alt+S 打开设置，然后选择 语言与框架 | Markdown。

2. 清除以下选项：

   • 在代码隔离中注入语言

   • 显示代码隔离中的问题

3. 点击 确定 以应用更改。

从 Markdown 文件运行命令

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

• 请点击相应的边栏图标或在光标位于您要运行的命令处时按 Ctrl+Shift+F10。

  

您可以在 IDE 设置 Ctrl+Alt+S 中禁用 Markdown 文件中运行命令的边框图标 语言和框架 | Markdown ：取消选中 检测可以直接从Markdown 文件运行的命令 复选框。

有关更多信息，请参见 Markdown 语言设置。

启用 Mermaid 图表支持

1. 按 Ctrl+Alt+S 打开设置，然后选择 插件。

2. 请查找并安装 Mermaid 插件。

启用 PlantUML 图表支持

1. 按 Ctrl+Alt+S 打开设置，然后选择 语言与框架 | Markdown。

2. 安装并启用 PlantUML 在 Markdown 扩展 下。

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

水平拆分编辑器和预览

默认情况下，编辑器和预览是垂直分割的（并排），这对于宽屏显示器很方便。 您还可以将其水平分割，这样预览会显示在编辑器的下半部分，这对于纵向显示器更为方便。

1. 在编辑器的右上角，点击 以打开 编辑器预览 窗格。

2. 点击 以水平分割编辑器和预览。

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

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

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

1. 按 Ctrl+Alt+S 打开设置，然后选择 语言与框架 | Markdown。

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

3. 点击 确定 以应用更改。

更改预览字体大小

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

1. 按 Ctrl+Alt+S 打开设置，然后选择 语言与框架 | Markdown。

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

3. 点击 确定 以应用更改。

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

插入图像

1. 按下 Ctrl+U。

   或者，请按 Alt+Insert 打开 插入… 弹出窗口，然后选择 图像。

   

2. 请在 插入图像 对话框中指定图像的路径。

   

3. 点击 确定。

插入链接

• 按下 Ctrl+Shift+U。

  或者，请按 Alt+Insert 打开 插入… 弹出窗口，然后选择 链接。

  

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

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

链接到其他文件和标题

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

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

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

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

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

在链接标签上 Ctrl+Click 以导航到引用的标头。

您可以在标题或标签上调用 查找用法(U) Alt+F7 以查看所有指向该标签的链接。 您还可以对标题或标签调用 重命名 重构 Shift+F6 ，以便与所有相关用法一起重命名。

生成目录

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

1. 将文本光标置于您希望添加当前文件的目录的位置，然后按 Alt+Insert 打开 插入… 弹出窗口。

2. 选择 目录。

   

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

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

插入表格

1. 按 Alt+Insert 打开 插入… 弹出窗口，并选择 表。

   

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

3. 请输入每个单元格的内容并按 Tab 键将插入点从一个单元格移动到下一个。 要添加新行，请按 Shift+Enter。 当您输入时，IntelliJ IDEA 会自动调整行和列，以适应表格单元格中的内容。

   有关在编辑表格时禁用辅助功能的信息，请参见 智能按键：Markdown

自定义浮动工具栏

1. 按 Ctrl+Alt+S 打开设置，然后选择 外观与行为 | 菜单和工具栏。

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

   有关更多信息，请参见 菜单与工具栏。

3. 点击 确定(O) 以应用更改。

隐藏浮动工具栏

1. 按 Ctrl+Alt+S 打开设置，然后选择 高级设置。

2. 选择 隐藏浮动工具栏 在 切换到 Markdown 模式 （${ hints.mdMode }） 下。

3. 点击 确定(O) 以应用更改。

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

• 在主菜单中，前往 代码 | 重新设置代码格式 或按 Ctrl+Alt+L。

配置 Markdown 代码样式设置

• 按 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 代码样式 | Markdown。

有关更多信息，请参见 Markdown 代码样式设置。

配置 Pandoc

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

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

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

3. 点击 确定 以应用更改。

从 Microsoft Word 导入

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

2. 请指定文档的位置。

导出 Markdown 文件为其他格式

IntelliJ IDEA 可以导出到 Microsoft Word（需要 Pandoc ）、PDF 和 HTML。

1. 请点击 编辑器和预览 或 预览 以在编辑器中显示 HTML 预览窗格。

2. 在主菜单中，前往 工具(T) | Markdown | 将Markdown 导出到…。

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

   

自定义 Markdown 的高亮显示

IntelliJ IDEA 根据 配色方案设置突出显示各种 Markdown 元素。

1. 在 设置 对话框（Ctrl+Alt+S ）中，选择 编辑器 | 颜色方案 | Markdown。

2. 选择颜色方案，接受从默认值继承的高亮设置，或按照 颜色和字体 中的描述进行自定义。

在大 Markdown 文件中导航

• 使用 结构 工具窗口 Alt+7 或 文件结构 弹出窗口 Ctrl+F12 来查看并跳转到相关的标题。

向 Markdown 文件添加注释

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

• 请将文本光标放在您想要注释掉的行上，然后按 Ctrl+/。

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

换行并填充段落

默认情况下，IntelliJ IDEA 不会自动对长行添加硬换行。 它将在您 重新格式化文件 时换行。

• 按 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 代码样式 | Markdown。 配置 Markdown 代码样式设置以在输入时启用自动换行。

• 或者，完全禁用硬换行，以保留超过配置的最大行长度的段落。

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