n8n 教程分享, 从 Github 读取.md 文档内容

作者：溪抱鱼

2025-07-19
河南
本文字数：2292 字
阅读完需：约 8 分钟

从上一篇我们了解到了如何安装 n8n
那么这节课我们尝试从 github 的个人仓库获取某个文件的内容

目标如下

content/business/1.how-to-use-money.mdx

总流程图

流程详解

第 1 步：申请 GitHub Personal Access Token (Classic)

在 gitrhub 个人设置选项申请 GitHub Personal Access Token (Classic)

在第二步之前我们点击➕,会进行选择 github 节点,我们先获取文件列表所以选择 List files

第 2 步：获取 content 目录列表 (第一个 GitHub 节点)

节点类型：GitHub
作用：流程启动后，首先会执行这个节点。它的任务是连接到您配置好的某个 GitHub 仓库，并获取根目录下名为 content 的文件夹里面所有文件和子文件夹的列表。
输出：一个包含多个项目的列表，每个项目都代表 content 目录下的一个文件或文件夹。

Credential to connect with (连接凭证):GitHub account 把我们刚申请的填入进去

User 为你的 github 用户 
Access Token 填入申请的 key
Resource (资源):File - 操作的 GitHub 资源类型是“文件”。
Operation (操作):List - 资源执行的操作是“列出”。结合起来就是“列出文件”。
Operation (操作)和 Resource (资源) 有其他的选项可以尝试结合
Repository Owner (仓库所有者):Shiinama - 指定了目标仓库是属于 Shiinama 这个用户或组织的。
Repository Name (仓库名称):blog - 指定了仓库的名字是 blog。
Path (路径):content - 指定了要列出内容的具体路径是仓库根目录下的 content 文件夹。

这个仓库的名称结合起来就是我的项目地址 https://github.com/Shiinama/blog

我们来尝试执行一下就会看到

已经成功列出了仓库的文件目录

第 3 步：获取子目录列表文件 (第二个 GitHub 节点)

节点类型：GitHub
作用：这个节点接收上一步传来的列表。它很可能会遍历这个列表，如果发现某个项目是文件夹，它就会进入这个子文件夹，并获取该子文件夹内部所有文件的列表。
输出：一个更详细的文件列表，包含了各个子目录下的文件信息（提到的 d1-and-drizzle.mdx 文件）。

同理在右上角添加 github 的 list files 

左侧的是我们上一个获取 content 目录列表请求到的结果

中间的参数填写完, 点击 Execute Step 会执行显示结果在右侧

点击左侧 path 选择复制

点击 Execute step 之后我们可以在右侧得到显示的结果

这一步之后,我们得到的就是目录下所有 mdx 文件格式的文章了之后我们需要进行 IF 过滤空值

Path 为我们需要得到的内容, 对其进行 IF 判断确保 path 的参数为 .mdx 结尾判空 

第 4 步：IF 条件判断 (If)

节点类型：逻辑判断 (Logic)
作用：这是一个过滤器。它会检查从上一步获取到的每一个文件，并根据您设定的条件进行判断。条件是“文件名是否以 .mdx 结尾？”或者“文件类型是否是 file？”。
分支：
true (上)：如果文件满足条件，就会从 true 路径输出。从图上看，目前 true 路径没有连接任何节点。
false (下)：如果文件不满足条件，就会从 false 路径输出。在您的流程中，数据流从 false 路径继续向下走。

IF 操作作为获取.mdx 防止.mdx 内容为空的一层

IF 的 True 节点进行连接下一个 Code1 节点

第 5 步：Code1 (第一个代码节点)

节点类型：Code
作用：这个节点接收从 IF 节点的 false 路径传来的文件数据。处理和准备 URL。例如：
从文件数据中提取 url 或 _links.self 字段。
使用代码去掉 URL 中多余的 ?ref=main 部分，生成一个干净的、可用于请求原始文件内容的 URL。

左侧是待处理,

右侧是处理好的

代码如下

// n8n Code Nodefor (const item of items) {
  // --- 第1部分：处理顶层的 'url' 字段 (和之前一样) ---  const topLevelUrl = item.json.url;  if (typeof topLevelUrl === 'string' && topLevelUrl.includes('?')) {    // 创建一个新的 'cleanUrl' 字段    item.json.cleanUrl = topLevelUrl.split('?')[0];  } else {    item.json.cleanUrl = topLevelUrl;  }

  // --- 第2部分：【新增】处理嵌套的 '_links.self' 字段 ---  // 先安全地检查 _links 对象和 _links.self 字段是否存在  if (item.json._links && typeof item.json._links.self === 'string') {        const selfUrl = item.json._links.self;
    // 同样检查它是否包含 '?'    if (selfUrl.includes('?')) {      // 如果包含，就直接修改（覆盖）原始 `_links.self` 字段的值      item.json._links.self = selfUrl.split('?')[0];    }  }
}
return items;

复制代码

第 6 步：HTTP Request (HTTP 请求节点)

节点类型：HTTP Request
作用：此节点会接收 Code1 处理好的干净 URL，然后向这个 URL 发起一个 HTTP GET 请求。它的目的就是获取文章的真正内容。您可能在这里设置了 Accept: application/vnd.github.raw 的 Header，来直接获取 Markdown 的源文本。