【免费下载链接】inkstoneA self-hosted Markdown notebook that runs entirely on Cloudflare Workers.项目地址https://gitcode.com/gh_mirrors/inksto/inkstone点击查看免费下载Inkstone 是一个运行在 Cloudflare Workers 上的自托管 Markdown 笔记应用而 Obsidian 的笔记库Vault本质上就是普通的.md文件加附件文件夹——这意味着迁移 Inkstone 出奇地简单把整个 Vault 打包成 zip 上传笔记、文件夹结构、图片附件、双链一次全部搬过去。本文是一份面向新手完整 Obsidian 迁移教程带你走通部署、导入、验证三个环节。 迁移前先看懂 Inkstone 会自动做什么Inkstone 的导入流程内置了专门的 Obsidian 兼容逻辑源码见 src/worker/lib/obsidian-import.ts以下要素全自动处理无需手动转换你的 Obsidian 内容Inkstone 的自动处理Markdown 正文原样保留GFM 表格、任务列表、代码块、数学公式、Mermaid 全部支持文件夹层级按相对路径在 Inkstone 中重建多级文件夹、![[pic.png]]、![[pic\|别名]]附件自动上传至 Inkstone 附件库正文引用自动重写obsidian-import.ts%% 单行注释 %%、%% 多行注释 %%转换为标准 HTML 注释不再出现在预览中stripObsidianComments[[双链]]WikiLink原生支持并可继续享受 Inkstone 的反向链接与关系图谱Front Matterstarred、pinned、archived、created、updated自动解析为收藏、置顶、归档和时间字段transfer.ts顶层notes/目录自动去除这一层前缀目录结构保持干净 一句话总结Obsidian 的纯文件设计正是迁移 Inkstone 最大的红利——你几乎不需要任何格式转换工具。第一步部署你自己的 Inkstone 实例Inkstone 是自托管应用数据库、附件和运行环境都由你掌控。部署只需几分钟完整步骤见 README_ZH.md 的「部署教程」将 Inkstone 仓库 Fork 到自己的 GitHub 账号或克隆到本地体验git clone https://gitcode.com/gh_mirrors/inksto/inkstone打开 Cloudflare 控制台的Workers Pages选择Continue with GitHub挑选你刚 Fork 的仓库使用 R2 存放附件时构建命令填npm run build部署命令填npm run deploy如果想用更轻量的 KV 模式把部署命令改成npm run deploy:kv等待部署完成打开生成的 Workers 域名用邮箱创建你的第一个账号。每个新账号会自动获得中文版和英文版两篇起始笔记方便你快速熟悉编辑器本地开发也可以直接运行npm run dev或npm run dev:demo启动纯前端体验版。第二步准备 Obsidian Vault 文件打开你的 Obsidian 应用找到Vault 所在文件夹设置 → 关于 → Vault 文件夹位置然后按以下方式准备整库迁移推荐在文件管理器中选中整个 Vault 文件夹包括笔记子目录和存放图片、PDF 的附件目录如assets、Attachments右键压缩为一个.zip文件。分散迁移笔记不多、或只想迁移部分内容时也可以不压缩直接选中若干.md/.markdown/.txt文件逐个导入。迁移前的三个小建议清理失效的块级引用页面级双链[[笔记名]]Inkstone 完全兼容但指向具体块/段落的[[笔记名#某段落]]在 Inkstone 中无法解析建议迁移前批量检查替换为普通页面链接。️确认附件目录在 Vault 内Inkstone 按 zip 内的相对路径匹配附件附件放在 Vault 外部比如系统剪贴板插件的临时目录将无法被识别。超大 Vault 分批单次导入上限为500 个文件、总计 64MBconstants.ts超过就把 Vault 按主题目录拆成几个 zip 依次导入。第三步在 Inkstone 中执行导入登录后进入「设置 → 数据」源码DataSettings.tsx页面底部就是导入区域提供两个入口「导入文件」点击「选择文件」可多选.md/.markdown/.txt/.json/.zip文件。整库迁移就上传你刚才压缩的 Vault zip「恢复备份文件夹」如果你之前从其他 Inkstone 实例拿到过 Markdown 备份文件夹可整目录上传恢复带 SHA-256 完整性校验。点击后 Inkstone 会在服务端自动完成%%注释%%转换 → 非 md 文件建立附件索引 → 逐个解析.md并上传笔记 → 把正文里的图片引用重写为新的附件地址importMarkdown。导入结束会弹出「导入完成」提示展示新建笔记数、文件夹数、附件数和警告信息。导入后5 分钟验证清单✅双链跳转随便点开一条[[双链]]确认能跳转到对应笔记 ✅反向链接打开任意笔记查看「反向链接」面板确认引用关系已重建 ✅关系图谱打开 Graph 面板观察节点连线是否符合你的知识库结构 ✅全文搜索用 D1 FTS5 全文搜索支持中文索引检索几个关键词 ✅附件显示打开含图笔记确认预览中图片正常加载 ✅警告信息回到设置页回顾导入提示中的警告未识别的附件通常就是失效引用或放在了 Vault 之外。常见问题与迁移限制限制项数值出处单篇笔记正文≤ 约 1.9MBconstants.ts单个附件≤ 25MBconstants.ts单次导入文件数≤ 500 个constants.ts单次导入总大小≤ 64MBconstants.ts文件夹嵌套深度≤ 12 层constants.ts支持的附件格式png / jpg / jpeg / gif / webp / avif / svg / pdfmimeForAttachmentNameQ迁移后再传一次同名笔记会覆盖吗Inkstone 导出/备份恢复的冲突策略有三种skip跳过、newer保留较新、duplicate另存为带(imported)后缀的副本界面文案为「同 ID 的笔记会保留较新的一份」。而直接导入 Obsidian 笔记时每次都会按普通 Markdown 新建笔记所以建议一次性规划好迁移批次避免重复导入产生大量副本。QInkstone 里还能导出回纯 Markdown 吗能。设置 → 数据 → 导出可选 JSON结构化数据或 ZIP可读 Markdown 快照 附件也可以配置WebDAV / S3 手动或定时异地备份实现见 src/worker/backup/。这样 Inkstone 就成了你的第二道保险随时可以反向迁回 Obsidian。QObsidian 的插件功能Dataview、Canvas 等怎么办Inkstone 提供的是原生能力替代方案大纲、专注模式、打字机模式、版本历史、双链图谱、可选的私有语义搜索Workers AI。依赖重度插件的工作流建议先评估再整体迁移。写在最后从 Obsidian 迁移到 Inkstone本质只是「部署一个自托管实例 上传一个 zip」——正文、双链、附件、目录结构全部无损保留之后你还能获得多设备同步、离线编辑、公开分享和定时异地备份等 Obsidian 免费版之外的能力。如果你的知识库以 Markdown 纯文本为主现在就可以动手试试这份完整迁移指南了 ✍️赞分享【免费下载链接】inkstoneA self-hosted Markdown notebook that runs entirely on Cloudflare Workers.项目地址https://gitcode.com/gh_mirrors/inksto/inkstone点击查看免费下载相关推荐Flomo导入Obsidian工具终极笔记迁移解决方案还在为如何从Flomo迁移到Obsidian而烦恼吗Flomo导入Obsidian工具为您提供了简单快速的笔记迁移解决方案。这款免费工具让您的知识管理之旅更加知识管理数据集成从OneNote到Markdown的完整迁移指南释放你的笔记自由从OneNote到Markdown的完整迁移指南释放你的笔记自由 还在为OneNote的封闭格式而烦恼吗OneNote Md Exporter正是你需要的笔CLI知识管理obsidian-git远程仓库迁移更换Git服务提供商指南obsidian git远程仓库迁移更换Git服务提供商指南 你是否正面临这些痛点 现有Git服务提供商访问速度慢影响笔记备份效率 担心服务关停导致多年笔开发工具版本控制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考