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

 N8n的基础安装分享

从上一篇我们了解到了如何安装 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 Node
for (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;

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.

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

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

URL里面填写下面的self

我们需要添加请求头,让github了解到我们的请求的是私有仓库和响应格式

Value里面需要填写我们申请的Key

格式:

登录后复制

token key //记得中间有空格

• 1.

请求头名称 (Name): Accept 请求头

内容 (application/vnd.github.v3+json) 分解：

• application/vnd.github：这是一个特定的媒体类型 (Media Type)，表示这是针对 GitHub API 的请求。
• v3：这部分指定了你希望使用 REST API 的 V3 版本。，可以确保你的应用不会因为未来 GitHub API 的版本更新而意外中断。
• +json：这表示你希望服务器返回的数据是 JSON 格式。

请求头名称 (Name): Accept

请求头值 (Value): application/vnd.github.raw

核心目的：直接获取文件的原始(Raw)内容。

执行 Execute step 右侧可以读取到文件的内容了

原文用markdown写的,输出原格式内容了

 关于我的一些介绍