Markdown

禁用代码块中的编码辅助

如果您的代码块不打算满足语法正确性，您可以关闭代码注入功能以及代码块中的语法错误检查。

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

2. 清除以下选项：

   • 在代码隔离中注入语言

   • 显示代码隔离中的问题

3. 点击 确定 应用更改。

从 Markdown 文件中运行命令

克隆项目后，通常会有一个 README.md 文件，包含运行应用程序、配置环境等操作的说明和命令。 WebStorm 可识别这些命令，并为运行命令提供侧边图标。

• 点击相应的侧边图标，或在光标位于所需运行的命令上时按下 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. 在 Markdown 扩展 中安装并启用 PlantUML。

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

水平拆分编辑器和预览

默认情况下，编辑器与预览以垂直方式（并排）排列，这样在宽屏显示器上更加方便查看。 您也可以选择水平拆分，使预览显示在编辑器下方，这样在竖屏显示器上将更加方便。

• 右键点击 Markdown 文件标签页的标题，并选择 拆分自下方

要配置预览的默认布局，您可以在 语言与框架 | 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)

WebStorm 会根据当前上下文提供可用链接标签的补全功能，包括相对于当前文件的文件及有效的标题标签。

按住 Ctrl+Click 点击链接标签以跳转到所引用的标题。

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

生成目录

您可以生成当前文件中可用标题的缩进列表。

1. 将光标放置到要添加当前文件目录的位置，然后按 Alt+Insert 打开 插入… 弹窗。

2. 选择 目录。

   

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

   

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

插入表格

1. 按 Alt+Insert 打开 插入… 弹窗，然后选择 表。

   

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

3. 输入每个单元格的内容，然后按 Tab 将光标移到下一个单元格。 要添加新行，请按 Shift+Enter。 在您输入时，WebStorm 会自动调整行列尺寸，以适应单元格中的内容。

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

自定义浮动工具栏

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

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

   

   如需了解更多信息，请参阅 菜单和工具栏。

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

隐藏浮动工具栏

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

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

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

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

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

配置 Markdown 代码样式设置

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

如需了解更多信息，请参阅 Markdown 代码样式设置。

配置 Pandoc

WebStorm 应能自动检测您的 Pandoc 安装。 如果未能检测到，请执行以下操作：

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

2. 在 Pandoc 设置 中指定 Pandoc 可执行文件的位置以及导入自 Microsoft Word 文档的图片的存储位置。

3. 点击 确定 应用更改。

从 Microsoft Word 导入

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

2. 指定文档的位置。

将 Markdown 文件导出为其他格式

WebStorm 可导出为 Microsoft Word（需要 Pandoc ）、PDF 和 HTML 格式。

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

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

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

   

自定义 Markdown 的高亮设置

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

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

2. 选择配色方案，接受从默认设置继承的高亮配置，或根据 颜色和字体 中的说明进行自定义。

在大型 Markdown 文件中导航

• 使用 结构 工具窗口 Ctrl+7 或 文件结构 弹窗 Ctrl+F12 浏览并跳转至相关标题。

向 Markdown 文件添加注释

Markdown 没有用于注释行的专用语法。 不过，可以使用不带地址的链接标签模拟注释行，例如：

• 将插入符号放置在要注释的行上，按 Ctrl+/。

  这将添加一个链接标签，将注释文本放入括号中，如有必要，还会在前面添加一个空行。 再次按下相同的快捷键可取消注释。

换行并填充段落

默认情况下，WebStorm 不会自动对长行进行硬换行。 当您 重新格式化文件时，它会对行进行换行。

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

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

• 您还可以使用 编辑(E) | 填充段落 操作，仅对插入符号所在段落添加换行。