Markdown 节点#
Markdown 节点用于在 Markdown 和 HTML 格式之间进行转换。
操作#
该节点的操作分为以下模式：
- Markdown 转 HTML：使用此模式将 Markdown 转换为 HTML
- HTML 转 Markdown：使用此模式将 HTML 转换为 Markdown
节点参数#
- HTML 或 Markdown：输入需要转换的数据。字段名称会根据您选择的模式而变化
- 目标键名：输入存放输出结果的字段。使用点号表示嵌套字段，例如
level1.level2.newKey
节点选项#
节点的选项取决于所选的模式。
测试选项效果
某些选项会相互依赖或产生交互影响。我们建议测试不同选项以确保效果符合预期。
Markdown 转 HTML 选项#
| 选项 | 描述 | 默认值 |
|---|---|---|
| 在新窗口打开链接 | 是否在新窗口打开链接（启用）或保持当前窗口（禁用）。 | 禁用 |
| 自动链接 URL | 是否自动将 URL 转换为链接（启用）或保持原样（禁用）。启用后，n8n 会将识别为 URL 的字符串自动转换为链接。 | 禁用 |
| 反斜杠转义 HTML 标签 | 是否允许使用反斜杠转义 HTML 标签（启用）或禁用此功能。启用时，n8n 会转义所有以 \ 开头的 < 或 >。例如 \<div\> 会渲染为 <div>。 |
禁用 |
| 完整 HTML 文档 | 输出完整 HTML 文档（启用）或 HTML 片段（禁用）。完整 HTML 文档包含 <!DOCTYPE HTML> 声明、<html> 和 <body> 标签以及 <head> 元素。 |
禁用 |
| 自定义标题 ID | 是否支持自定义标题 ID（启用）或禁用此功能。启用后，您可以在标题文本后使用 {自定义ID} 添加自定义标题 ID。 |
禁用 |
| 表情符号支持 | 是否支持表情符号（启用）或禁用此功能。 | 禁用 |
| 编码电子邮件 | 是否将 ASCII 字符电子邮件转换为其等效的十进制实体（启用）或保持原样（禁用）。 | 启用 |
| 排除 URL 尾部标点 | 是否从自动链接的 URL 中排除尾部标点符号（启用）或包含标点（禁用）。需配合自动链接 URL使用。 | 禁用 |
| GitHub 代码块 | 是否启用 GitHub 风格代码块（启用）或使用标准代码块（禁用）。 | 启用 |
| GitHub 兼容标题 ID | 是否生成 GitHub 风格的标题 ID（启用）或禁用此功能。GitHub 风格会用 - 替换空格并移除非字母数字字符。 |
禁用 |
| GitHub 提及链接 | 更改GitHub 提及功能的链接地址。 | 禁用 |
| GitHub 提及 | 是否支持使用 @ 标记 GitHub 用户（启用）或禁用此功能。启用后，n8n 会将 @用户名 替换为 https://github.com/用户名。 |
禁用 |
| GitHub 任务列表 | 是否支持 GitHub 风格任务列表（启用）或禁用此功能。 | 禁用 |
| 标题起始级别 | 数字。设置标题的起始级别。例如将此值设为 2 会使 # 被视为 <h2>，## 被视为 <h3>，以此类推。 |
1 |
| 标题前必须空格 | 是否要求 # 和标题文本之间必须有空格（启用）或不做要求（禁用）。启用后，##无空格标题 会被原样渲染而不会转换为标题元素。 |
禁用 |
| 单词中间星号 | 是否将单词中的星号视为 Markdown 语法（禁用）或原样显示星号（启用）。 | 禁用 |
| 单词中间下划线 | 是否将单词中的下划线视为 Markdown 语法（禁用）或原样显示下划线（启用）。 | 禁用 |
| 禁用标题 ID | 禁用自动生成标题 ID（启用）。 | 禁用 |
| 解析图片尺寸 | 支持在 Markdown 语法中设置图片最大尺寸（启用）。 | 禁用 |
| 标题 ID 前缀 | 定义要添加到标题 ID 的前缀。 | 无 |
| 原始标题 ID | 是否从标题 ID（包括前缀）中移除空格、单引号和双引号，并用 - 替换（启用）或保持原样（禁用）。 |
禁用 |
| 原始前缀标题 ID | 是否阻止 n8n 修改标题前缀（启用）或允许修改（禁用）。 | 禁用 |
| 简单换行 | 是否允许在行尾没有双空格的情况下创建换行（启用）或要求双空格换行（禁用）。 | 禁用 |
| 智能缩进修复 | 是否智能修复缩进代码块中与 ES6 模板字符串相关的缩进问题（启用）或禁用此功能。 | 禁用 |
| 子列表空格缩进 | 是否移除子列表需要缩进四个空格的要求（启用）或保持此要求（禁用）。 | 禁用 |
| 分割相邻引用块 | 是否分割相邻的引用块（启用）或合并处理（禁用）。如果不启用，n8n 会将不同行（以 > 开头）的引用视为单个引用块，即使中间有空行分隔。 |
禁用 |
| 删除线 | 是否支持删除线语法（启用）或禁用此功能。启用后，您可以使用 ~~ 包围文字来添加~~删除线~~效果。 |
禁用 |
| 表格标题 ID | 是否为表格标题标签添加 ID（启用）或禁用此功能。 | 禁用 |
| 表格支持 | 是否支持表格（启用）或禁用此功能。 | 禁用 |
HTML 转 Markdown 选项#
| Option | Description | Default |
|---|---|---|
| 项目符号标记 | 指定用于无序列表的字符。 | * |
| 代码块围栏 | 指定用于代码块的字符。 | ``` |
| 强调分隔符 | 指定 <em> 的字符。 |
_ |
| 全局转义模式 | 覆盖默认的字符转义设置。建议改用文本替换模式。 | 无 |
| 忽略元素 | 忽略指定的 HTML 元素及其子元素。 | 无 |
| 保留数据图像 | 是否保留带有数据的图像（启用）或不保留（禁用）。支持最大 1MB 的文件。 | 禁用 |
| 行首转义模式 | 覆盖默认的字符转义设置。建议改用文本替换模式。 | 无 |
| 最大连续换行数 | 数字。指定允许的最大连续换行数。 | 3 |
| URL 置于底部 | 是否将 URL 放置在页面底部并使用链接引用定义格式（启用）或不放置（禁用）。 | 禁用 |
| 加粗分隔符 | 指定 <strong> 的字符。 |
** |
| 代码块样式 | 指定代码块的样式。选项为 围栏式 和 缩进式。 | 围栏式 |
| 文本替换模式 | 使用正则表达式定义文本替换模式。 | 无 |
| 视为块元素 | 指定应视为块元素的 HTML 元素（用空行包围） | 无 |
模板与示例#
解析器#
n8n 使用以下解析器：
- 用于从 HTML 转换为 Markdown：node-html-markdown
- 用于从 Markdown 转换为 HTML：Showdown。部分选项允许您使用 GitHub Flavored Markdown 来扩展您的 Markdown 功能。