llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

Markdown

Markdown 是一种轻量级标记语言,用于在纯文本中添加格式元素。 IntelliJ IDEA 可识别 Markdown 文件,并提供具备高亮显示、补全和格式设置功能的专用编辑器。 支持基于 CommonMark 规范。

启用 Markdown 插件

此功能依赖于 Markdown 插件,该插件默认情况下在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

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

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

创建新的 Markdown 文件

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

  1. 右键点击 项目 工具窗口(Alt+1 )中的目录,然后选择 新建 | 文件。

    或者,可以选择所需目录,按 Alt+Insert ,然后选择 文件。

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

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

Markdown 编辑器格式工具栏

在当前 project 中也有针对文件链接的 代码补全 ,例如,如果您需要引用源代码、图像或其他 Markdown 文件。 更多信息请参阅 链接。

Markdown 编辑器补全弹窗

Markdown 格式设置

浮动工具栏

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

Markdown浮动工具栏

在普通文本和从 H1 到 H6 的标题级别之间进行选择。

  • 粗体粗体 Ctrl+B

  • 斜体斜体 Ctrl+I

  • 删除线删除线 Ctrl+Shift+S

  • 代码代码 Ctrl+Shift+C

  • 创建链接创建链接 Ctrl+Shift+U

  • 无序列表无序列表

  • 有序列表有序列表

  • 勾选列表勾选列表

自定义浮动工具栏

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

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

    有关更多信息,请参见 菜单和工具栏。

  3. 点击 OK 以应用更改。

隐藏浮动工具栏

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

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

  3. 点击 OK 以应用更改。

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

[link-text](link-url "optional-title")
在 Markdown 文件中插入链接
  • 按下 Ctrl+Shift+U。

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

    在 Markdown 文件中插入链接

如果已高亮显示一些文本,它将作为链接文本包含在 [ ] 中。 如果您已将 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 以导航到引用的标头。

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

镜像

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

![alt-text](path/to/file.png "optional-title")
在 Markdown 文档中插入的图片

插入图像

  1. 按下 Ctrl+U。

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

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

    Markdown 插入图片对话框

要配置图像,请在插入该图像的行的装订区域中点击 配置图标。 例如,您可以在 转换为 HTML 和 插入图像 对话框中选择 配置图像 ,将带有原始 HTML 标记的图像插入 Markdown 文件。

使用原始 HTML 插入图片

这将产生以下结果:

以原始 HTML 插入的图像

列表

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

Markdown 文件中显示的不同类型列表

IDE 会在输入时自动调整列表中的缩进,以匹配层次结构。 可以在设置中禁用此行为:按 Ctrl+Alt+S 打开设置,选择 编辑器 | 常规 | 智能键 | Markdown ,然后禁用 输入时调整缩进。

配置列表中的编号

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

  1. 按 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 智能键 | Markdown。

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

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

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

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

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

    • 使用之前的数字 :为每个新项重复使用前一项的编号(例如 5.、 5.、 5.)。 该选项便于编辑和重新排序,并保留列表现有的起始编号。

表

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

插入表格

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

    在 Markdown 文件中插入表格
  2. 选择表格的大小(行数和列数)。

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

    有关在编辑表格时禁用辅助功能的信息,请参阅 智能按键:Markdown。

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

对格式错误的表格进行 Markdown 检查

IntelliJ IDEA 会在编辑器中自动对齐表格单元格和列分隔符,而不修改表格的源文本,使表格更易于阅读。 如果要查看没有这种对齐的表格,请在 设置 | 语言 & 框架 | Markdown 中禁用 视觉对齐表格单元格。

|One |Two |Three |Four | |--- |--- |--- |--- | | | | | | | | | | | | | | | |
|One |Two |Three |Four | |---|---|---|---| | | | | | | | | | | | | | | |

默认情况下,IntelliJ IDEA 在编辑器中显示表格列和行标记。 使用这些标记来选择、移动、插入、移除和对齐列和行。 标记是特定于 Markdown 文件的 内嵌提示的一种特殊类型。 如果未看到这些标记,请按 Ctrl+Alt+S 打开 IDE 设置,转到 编辑器 | 内嵌提示 ,并勾选 其他 | Markdown | 表内嵌显示 选项。

在 Markdown 文件中编辑表格

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

  • “向左移动列”按钮左移列

  • "右移列按钮"右移列

  • “在左侧插入列”按钮插入左侧列

  • 插入右侧列按钮插入右侧列

  • 选择列单元格按钮选择列单元格

  • 左对齐按钮左对齐

  • 居中对齐按钮居中对齐

  • 右对齐按钮右对齐

  • 删除列按钮移除列

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

  • “上移行”按钮上移行

  • 向下移动行按钮下移行

  • 插入上方行按钮在上方插入行

  • “在下方插入行”按钮在下方插入行

  • “选择行”按钮选择行

  • 删除行按钮移除行

代码块

要插入一个围栏代码块,请在代码块前后使用三个反引号 ```。 如果您指定代码块的语言,Markdown 编辑器会默认 注入相应的语言。

这将启用指定语言的语法高亮和其他编码辅助功能: completion、 inspections 和 intention actions。

在 Markdown 中插入一个围栏代码块

在代码块中禁用编码辅助

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

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

  2. 清除以下选项:

    • inject 语言到代码区块中

    • 在代码围栏中显示错误

  3. 点击 OK 以应用更改。

从 Markdown 文件运行命令

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

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

    运行命令时,可以 选择用作工作目录的目录 :父文件目录或项目目录。

    在 Markdown 文件中检测到的用于运行命令的装订区域图标

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

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

数学表达式

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

Markdown 中的数学表达式

如果您想插入字面意义上的美元符号,请使用反斜杠对其进行转义: \$ 或 \$$。

图

Markdown 编辑器可以渲染用 Mermaid 和 PlantUML 定义的图表。 默认情况下这是禁用的,需要额外的步骤。

Markdown 中的 Mermaid 图表

启用 Mermaid 图表支持

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

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

启用 PlantUML 图表支持

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

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

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

目录

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

生成目录

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

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

  2. 选择 目录。

    在 Markdown 文件中创建目录

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

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

<!-- 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 -->

从目录中省略标题

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

  • 将文本光标放在要省略的标题处,按 Alt+Enter ,然后选择 从目录中省略标题。

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

预览 Markdown

默认情况下,Markdown 编辑器会在 Markdown 源文件旁显示已渲染 HTML 代码的预览窗格。 您可以点击 编辑器按钮编辑器 或 预览按钮预览 在 Markdown 编辑器的右上角,仅显示编辑器或预览窗格。

水平拆分编辑器和预览

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

  1. 在编辑器右上角,点击 打开编辑器预览按钮 打开 编辑器预览 窗格。

  2. 点击 打开编辑器预览按钮 以水平拆分编辑器和预览。

Markdown 编辑器和实时预览窗格垂直分割

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

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

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

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

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

  3. 点击 OK 以应用更改。

更改预览字体大小

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

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

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

  3. 点击 OK 以应用更改。

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

自定义 CSS

IntelliJ IDEA 提供用于在预览窗格中渲染 HTML 的默认样式表。 这些样式表旨在与默认的 UI 主题保持一致。 您可以配置特定的 CSS 规则来进行小的呈现更改:例如,更改标题的字体大小或列表中的行间距。 或者您可以提供一个全新的 CSS 来更好地匹配您的预期输出:例如,如果您想复制 GitHub Markdown style。

具有自定义 CSS 的 Markdown 预览,类似 GitHub 渲染风格

配置 CSS 以渲染 HTML 预览

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

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

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

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

  3. 点击 OK 以应用更改。

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

body { background: #DDDDDD; color: #888888; font-size: 250% !important; } strong { text-decoration: underline; }

重新格式化 Markdown 文件

IntelliJ IDEA 可以使用适当的换行、空行和缩进来 重新格式化 Markdown 文件。

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

  • 在主菜单中,转到 代码 | 格式化代码 或按 Ctrl+Alt+L。

IntelliJ IDEA 根据 Markdown 文件的 代码样式设置格式化内容。

配置 Markdown 代码样式设置

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

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

换行并填充段落

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

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

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

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

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

向 Markdown 文件添加注释

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

[//]: # (Your comment text)

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

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

    自定义 Markdown 的高亮显示

    IntelliJ IDEA 会根据 配色方案 设置高亮显示各种 Markdown 元素。

    1. 在 设置 对话框(Ctrl+Alt+S )中,选择 编辑器 | 配色方案 | Markdown。

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

    转换 Markdown 文件

    Markdown 插件可以直接将您的 Markdown 文件导出为 HTML 和 PDF。 如果您配置 Pandoc ,它也能够导出到 Microsoft Word 文件(DOCX)并从中导入。

    配置 Pandoc

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

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

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

    3. 点击 OK 以应用更改。

    从 Microsoft Word 导入

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

    2. 请指定文档的位置。

    导出 Markdown 文件为其他格式

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

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

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

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

      Markdown 导出对话框
    2026年 11月 3日