语雀图床迁移教学
本教程发布于 2025 年 7 月，工具界面与免费额度可能已有变化，流程仅供参考。现在建站推荐使用 👉 AllinCMS；建站后的选题思路见 不知道写什么？问 AI。
接前文：建站后的内容与选题方法见 不知道写什么？问 AI；现在的建站工具推荐 👉 AllinCMS（早期建站教程已历史化）。
在内容创作和迁移的过程中，我们常常会遇到一个棘手的问题：从语雀、Notion等笔记平台导出的内容，其图片链接往往带有“防盗链”机制。这意味着，当你把这些内容直接发布到自己的网站或博客时，图片会全部失效，显示为一个难看的“裂图”图标。
本文将提供一个终极解决方案：利用强大的Markdown编辑器小书匠（Story-writer），配合免费稳定的GitHub作为图床，实现对这些带防盗链的图片链接进行一键式、批量的迁移。本教程将覆盖从软件安装、图床配置，到实战转换的全过程，并对新手极易遇到的每一个坑都进行详细说明和图解，确保你跟着走就能成功。
一、准备工作
首先，我们需要下载并安装小书匠。请根据你的操作系统选择对应的版本。
下载链接：
- Win64位版本： https://dd.laifa.xin/xsj-win64.exe (内存大于4G的Windows系统建议下载此版)
- Win32位版本： https://dd.laifa.xin/xsj-win32.exe
- macOS (Apple Silicon M1/M2/M3) 版本： https://dd.laifa.xin/xsj-osxarm.zip
- macOS (Intel) 版本： https://dd.laifa.xin/xsj-osx64.zip
【macOS M系列芯片用户特别注意】
如果你使用的是 M1/M2/M3 等 ARM 架构的 Mac，下载 osxarm 版本后，若发现应用无法启动，请打开“终端”应用，执行以下命令：
# 假设你把解压后的文件放在了“下载”文件夹
cd /Users/你的用户名/Downloads/Story-writer-osxarm
xattr -cr ./Story-writter.app
这个命令会移除macOS的安全隔离属性，允许应用正常运行。安装过程与其他软件无异，此处不再赘述。
二、基础设置
为了方便我们后续观察Markdown源码和预览效果，建议关闭小书匠默认的“所见即所得”模式。
-
打开小书匠，在编辑器下方的状态栏找到并点击“修改编辑器配置”。
-
在弹出的配置窗口中，取消勾选“所见即所得”。
设置后，你的编辑器将变为左侧是Markdown源码，右侧是实时预览的经典布局，这对于我们检查图片链接是否被正确替换非常有帮助。
三、绑定图床
这是整个流程中最关键也是最容易出错的一步。我们将分步完成GitHub的设置，并将其绑定到小书匠。
步骤1：进入绑定
-
点击小书匠左下角的齿轮图标，进入“设置”。
-
在设置菜单中，选择“存储” > “绑定”。
-
在图床服务列表中，找到并点击
githubimg进行配置。
步骤2：获取令牌
Token相当于小书匠访问你GitHub仓库的密码，请务必妥善保管。
-
在
githubimg配置界面，点击token旁边的链接，它会引导你跳转到GitHub的Token生成页面。
-
登录你的GitHub账号（支持Google快速登录）。
-
在“New personal access token”页面进行如下设置：
- Note：给这个Token起个名字，方便自己识别，如
xiaoshujiang-token。 - Expiration：设置有效期，建议选择“No expiration”（永不过期）或较长时间。
- Select scopes：这是最重要的一步！必须勾选
repo，它会自动包含所有子权限。
- Note：给这个Token起个名字，方便自己识别，如
-
拉到页面底部，点击“Generate token”按钮。
-
立即复制并保存生成的Token！ 这个Token只会显示一次，离开页面后将无法再次查看。
步骤3：建仓库
这个仓库将作为我们存放图片的网络空间。
-
在GitHub页面，点击右上角的“+”号，选择“New repository”，或者直接访问 github.com/new。
-
设置仓库信息：
- Repository name：给仓库起个名字，例如
nibaba。 - Public/Private：必须选择
Public（公开），否则图片无法被外部访问。 - 点击“Create repository”。
- Repository name：给仓库起个名字，例如
-
仓库创建成功。
-
【重点！防坑指南】初始化仓库。 新创建的空仓库无法直接使用，否则小书匠会报错。我们必须在里面创建一个文件来完成初始化。最简单的方法是创建一个
README.md文件。- 点击页面上的“creating a new file”或“Add a README file”。
- 文件名默认为
README.md，无需修改。直接点击右上角的“Commit changes...”，在弹窗中再次点击“Commit changes”。
-
初始化完成。请注意，此时仓库的主分支名称是
main。
步骤4：完成配置
现在，回到小书匠的githubimg配置界面，填入我们准备好的信息。
- token：粘贴你刚刚在GitHub生成的Token（通常以
ghp_开头）。 - 仓库：填写你的仓库名称，例如
nibaba。 - 文件名称生成规则：建议修改为
/img/{{filename}}，这样所有图片都会存放在仓库的img目录下，便于管理。避免使用中文路径。 - 【重点！防坑指南】对应的分支：务必将默认的
master修改为main，与你在GitHub上看到的分支名保持一致。
步骤5：常见问题
如果在配置或测试中遇到错误，99%是以下两个原因：
-
错误1：仓库未初始化 (409 Conflict Error) 如果你跳过了初始化仓库的步骤，测试时会看到类似下面的
409错误。{"path":"/repos/apan-tony/nibaba/git/refs/heads","request":{"dataType":"json"},"error":409}
解决方案： 返回GitHub，按照步骤3的方法，在仓库里创建一个README.md文件。 -
错误2：分支名称不匹配 如果你的分支是
main，但小书匠里填的是master，会看到下面的报错。
解决方案： 在小书匠的githubimg配置中，将“对应的分支”从master修改为main。
步骤6：激活并测试图床
-
配置无误后，回到“绑定”页面，勾选
githubimg，使其成为当前默认的图床服务。
-
关闭设置窗口，返回主编辑器界面。
-
测试粘贴上传：随便截一张图，然后在小书匠的编辑器中按下
Ctrl+V(或Cmd+V) 粘贴。如果图片链接自动变成了以raw.githubusercontent.com开头的地址，恭喜你，图床配置成功！
四、批量迁移
万事俱备，现在开始执行最终的转换任务。
步骤1：找到图床转移
-
首先，将你从语雀等平台复制的、包含旧图片链接的Markdown全文，粘贴到小书匠的编辑器中。
-
在编辑器的顶部菜单栏找到并点击“图床转移”按钮。
【提示】 如果你没有看到这个菜单栏，可能是因为处于“页签模式”。可以点击左上角的“切换页签模式”按钮。
切换后，你应该就能在右侧看到“图床转移”按钮了。
步骤2：执行转换
我们以下面这段包含语雀图片链接（cdn.nlark.com）的代码为例：
<font style="color:#FF0000;">产品编号HY-001</font>
<font style="color:#FF0000;">产品名称:长方形玻璃保鲜饭盒（两分格） （1040ML）</font>
<font style="color:#FF0000;">容量:1040ML</font>
<font style="color:#FF0000;">产品编号HY-003</font>
<font style="color:#FF0000;">产品编号HY-004</font>
<font style="color:#FF0000;">产品名称:圆形玻璃保鲜饭盒（两分格） （960ML）</font>
<font style="color:#FF0000;">容量:960ML</font>
-
将上述内容粘贴到小书匠后，点击“图床转移”。
-
在弹出的“网络图片地址转换”窗口中，勾选右上角的“全选”，然后点击最下方的“转换”按钮。此时“转换后地址”一栏是空的。
-
耐心等待。小书匠会开始下载原图片并上传到你的GitHub仓库，窗口会显示“处理中...”。此过程请勿进行任何操作。
步骤3：验证结果
-
转换完成后，“转换后地址”一栏会填上新的GitHub链接。点击“确定”按钮。
-
回到编辑器，你会发现文中的所有图片链接都已经被成功替换了！
转换后的内容如下，图片链接已经变成了稳定、无防盗链的GitHub链接：
<font style="color:#FF0000;">产品编号HY-001</font>
<font style="color:#FF0000;">产品名称:长方形玻璃保鲜饭盒（两分格） （1040ML）</font>
<font style="color:#FF0000;">容量:1040ML</font>
<font style="color:#FF0000;">产品编号HY-003</font>
<font style="color:#FF0000;">产品编号HY-004</font>
<font style="color:#FF0000;">产品名称:圆形玻璃保鲜饭盒（两分格） （960ML）</font>
<font style="color:#FF0000;">容量:960ML</font>
至此，你已经成功地将所有图片迁移到了自己的图床。这份处理好的Markdown“原料”，现在可以放心地交给AI进行下一步的梳理和美化，或者直接用于发布你的网站和博客了。