小书匠：本地优先的 Markdown 编辑器与知识管理工具 #

小书匠是什么？ #

小书匠是一款不止于 Markdown 编辑器，更是功能丰富、强大的知识管理工具。它以「本地优先、去中心化、支持自定义同步」为设计理念，既能满足日常写作与排版需求，又能把零散笔记沉淀为结构化的个人知识库。

小书匠面向写作者、程序员、学生以及对知识管理有较高要求的用户，支持标准与高级 Markdown 语法，并内置思维脑图、流程图、序列图、数学公式、PlantUML、Mermaid、音视频附件等大量扩展语法。同时，它提供全文搜索、过滤器、链接关系图、版本管理、PDF 批注和第三方存储同步等能力，帮助用户把「写作—整理—检索—复用」串成一条完整链路。官方当前最新版本为 v8.16.0，并提供 Windows、macOS、Linux、Android、iOS 以及 Web、浏览器插件等多端形态。

小书匠有哪些亮点特色？ #

• 本地优先，数据自主可控：小书匠采用本地优先、去中心化的架构，数据默认保存在本地；同步功能默认关闭，是否上传由用户自行决定，兼顾隐私与灵活性。
• 强大的 Markdown 语法体系：除标准语法外，还支持表格、大纲、脚注、待办、MathJax 公式、流程图、序列图、emoji、自定义 class 等高级语法，并独创思维脑图、中文斜体、PlantUML、Wavedrom、Mermaid、Plot 统计图、注音、印刷字替换等专有语法。
• 所见即所得与多编辑器模式：内置 Codemirror 编辑器、立时预览（所见即所得）、子编辑器等模式，搭配查找替换、片段脚本、快捷键与命令系统，写作效率更高。
• 知识组织与检索能力：提供过滤器、二次过滤（快速过滤）、文章置顶、内部链接、wiki 链接、链接关系图、待办列表视图、全文搜索与数据中心，让笔记真正「可被找到」。
• 萤火虫模式与版本管理：以时间流方式改进知识管理，配合类似 Git 的版本管理机制，删除操作为逻辑删除，可在回收站清空后彻底删除，避免误删风险。
• 丰富的导入导出与 PDF 能力：支持导入导出、PDF 导出，可结合会员功能解锁 Just One Page PDF（JOPP）插件，将网页高保真保存为矢量 PDF，文字可选中、可无限放大，适合文章剪藏与 PDF 批注。
• 第三方存储与图床集成：支持第三方存储绑定、第三方存储查询、图床、图片查看器与图片编辑器，图片资源可远程引用与管理，方便多端迁移与备份。
• 多端与自部署方案：提供 Windows、macOS、Linux 桌面版，Android/iOS 手机版（有影笔记），PWA 版安装，以及 Docker 自部署版本 Pegasus（天马版）和 GitHub Pages 静态自部署版本 Lucky-cat（招财猫版）。

免费下载小书匠 #

以下为官方提供的 Windows 安装包，点击链接即可通过夸克网盘下载。

提示：Mac M1/M2 用户请下载 osxarm 版本；自 2.0.0 版本起，小书匠不再支持 Windows XP 与 OSX 32 位系统。若需获取其他平台或更多历史版本，可访问官网下载页 https://soft.xiaoshujiang.com/download/。

小书匠 如何使用？ #

1. 安装并启动：下载对应平台安装包完成安装，首次启动后小书匠会初始化本地数据库并建立索引，文章较多时首次进入可能需要等待一段时间。
2. 认识主界面：左侧为文件/分类/过滤器导航区，中间为编辑器，右侧为预览或大纲面板；通过顶部「小书匠」主按钮可访问数据、关于、设置等入口。
3. 新建与编辑文章：点击新建文章，使用 Markdown 语法撰写内容；可切换 Codemirror 编辑器或立时预览（所见即所得）模式，按需使用片段、快捷键与命令提升写作速度。
4. 组织与检索知识：为文章打标签、加分类，或使用过滤器与二次过滤规则进行结构化搜索；通过链接关系图与 wiki 链接建立笔记之间的关联。
5. 导出与同步：使用导入导出或 PDF 导出功能输出成稿；如需跨设备同步，会员用户可在用户中心按需开启配置文件同步与数据文件同步。

小书匠的常见问题？ #

Q1：为什么删除文章后空间占用没有变小？ 小书匠的数据存储类似 Git，提供版本管理机制，删除一般为逻辑删除，只有进入回收站并清空后才会真正释放空间，因此删除后磁盘占用不会立即下降。

Q2：如何修改小书匠的数据存储位置？ 可在「小书匠主按钮 > 数据」或「小书匠主按钮 > 关于」界面查看当前数据目录。数据目录转移前请务必备份旧数据，避免操作失败造成数据丢失；Windows、Linux、macOS 配置方式类似。

Q3：升级后无法打开或索引重建很慢怎么办？ 如果从较老版本升级，内置数据库可能存在不兼容问题，官方建议在升级前先导出数据或备份数据库文件（Windows 路径为 %LOCALAPPDATA%/storywriter/）。系统升级后会自动重建索引，文章较多的用户需要等待较长时间才能再次进入。

Q4：Mac 上提示无法启动怎么办？ Mac M1/M2 机器请下载 osxarm 版本。如果仍无法启动，可在终端中执行 xattr -cr ./Story-writer.app 清除隔离属性后再尝试打开。

Q5：会员功能有哪些？ 会员用户可以自行开启配置文件与数据文件同步功能。由于同步需要经过小书匠服务器，出于数据隐私考虑系统默认关闭该功能，是否开启由会员用户自行决定；JOPP 插件的全部功能也需要会员解锁。

Q6：小书匠支持哪些平台？ 桌面端支持 Windows、macOS、Linux；移动端提供 Android 与 iOS 版本（有影笔记）；此外还提供 PWA 网页版、Chrome 浏览器插件（Just One Page PDF），以及 Docker 自部署版本 Pegasus 和 GitHub Pages 静态自部署版本 Lucky-cat。

小书匠如何安装？ #

Windows #

1. 下载对应的 Story-writer-win32-setup.exe 或 Story-writer-win64-setup.exe；
2. 双击安装包，按向导提示选择安装路径并完成安装；
3. 首次启动后等待索引初始化，即可开始使用。

若从较老版本升级，请先导出数据或备份数据库文件，避免升级失败导致数据不兼容。

macOS #

1. 前往官网下载页获取 macOS 版本，M1/M2 芯片用户请选择 osxarm 版本；
2. 打开 .dmg 或 .pkg 安装包，将应用拖入「应用程序」目录完成安装；
3. 如遇无法启动，在终端执行 xattr -cr ./Story-writer.app 后重试。

Linux #

1. 从官网下载页获取 Linux 版本安装包；
2. 按发行版使用对应的包管理器或解压后运行；
3. 配置文件默认位于 ~/.config/storywriter。

Android / iOS #

• Android：前往官网下载页点击「Android 下载(Github)」获取安装包；
• iOS：通过官网入口跳转 App Store 下载「有影笔记（小书匠手机版）」。

PWA / 自部署 #

• PWA：访问官网 PWA 安装入口，按提示将小书匠添加到桌面；
• Docker 自部署：参考官网「Pegasus 天马版」安装教程部署；
• 静态自部署：参考官网「Lucky-cat 招财猫版」代码地址与演示地址部署。

小书匠如何卸载？ #

Windows #

1. 打开「控制面板 > 程序和功能」（或「设置 > 应用」）；
2. 找到「小书匠 / Story-writer」，点击卸载并确认；
3. 如需彻底清理，可手动删除数据库目录 %LOCALAPPDATA%/storywriter/（卸载前请确认已完成数据导出或备份）。

macOS #

1. 打开「访达 > 应用程序」，将「小书匠 / Story-writer」拖入废纸篓；
2. 输入管理员密码并清空废纸篓；
3. 如需彻底清理，可删除 ~/Library/Application Support/storywriter/ 目录中的本地数据。

Linux #

1. 使用对应包管理器卸载安装的小书匠，或删除解压目录；
2. 如需彻底清理，删除 ~/.config/storywriter 目录；
3. 卸载前请务必先备份数据。

通用提醒：小书匠的数据目录包含本地数据库与配置信息，卸载应用通常不会自动删除这些文件。若希望彻底清理，请在确认备份后手动删除对应目录，避免误删造成知识库丢失。