TiddlyWiki

介绍#

TiddlyWiki 是一款极具极客浪漫和高度可定制性的个人知识库/笔记软件。它最迷人的地方在于：整个软件、你的所有笔记、插件、样式，全都浓缩在一个单文件（.html）里。

• 一个奇迹般的单文件：没有繁重的客户端，一个 .html 文件就是你的全部世界。

• 非线性卡片笔记的鼻祖：早在 Roam Research 和 Obsidian 流行之前，TiddlyWiki 已经玩转了卡片化（Tiddlers）和双向链接。

• 数据主权神圣不可侵犯：100% 本地、开源、免费，不依赖任何云服务商，你的数据哪怕过了 20 年依然能用任何浏览器打开。

核心概念#

Tiddler#

TiddlyWiki 的基本单位叫 Tiddler，中文常译作“条目”。条目越小，越容易被重新组合。对于软件资料、术语表、任务清单、写作素材这类内容，条目的粒度往往比长文更合适。

比如整理一款软件时，可以把内容拆成几条：

• 软件名称
• 安装方式
• 适用场景
• 使用限制
• 替代方案
• 后续要补充的点

这样做的好处是，后面可以把这些条目组合成目录、专题页或评测草稿，而不是把所有内容都锁进一篇长文里。

这种结构开始时会显得有点陌生，但一旦理解，就会发现它很适合收集零散材料。内容越多，标签、链接和筛选器的价值越明显；它更像一个会慢慢长出结构的小知识系统，而不是一个只负责写长文的笔记本。

标签和链接#

标签不只是分类，更像是自动生成列表的入口。给条目打上同一个标签，就能把同类内容聚在一起。链接则负责把条目之间的关系织成网络。

常用写法很简单：

[[条目标题]]
[[显示文字|条目标题]]

当某个概念需要反复引用，或者某个软件会在多处出现时，再把它拆成独立条目会更自然。TiddlyWiki 的结构感，主要就是靠这些链接慢慢长出来的。

筛选器#

筛选器是 TiddlyWiki 最有辨识度的部分。它让 Wiki 不只是笔记集合，更像一个小型数据库。

例如列出某个标签下的条目：

[tag[开源]]

例如按创建时间排序：

[tag[开源]sort[created]]

新手不必一开始就学完复杂语法。先会按标签生成列表，已经足够做出实用的目录页和项目面板。

保存方式#

这是 TiddlyWiki 新手最先遇到的问题。由于浏览器安全限制，单文件版本并不能像普通网页那样简单地 Ctrl+S 完事。要用得顺手，先选对保存方式。

单文件方案#

单文件版最有代表性，整个 Wiki 就是一个 HTML 文件。适合想快速体验、愿意手动备份的人。

可以考虑的方式包括：

• 官方单文件版
• 浏览器保存扩展
• 桌面壳应用

这种方式的优点是便携，缺点是保存流程必须先理顺。没解决好保存问题，后面的条目、标签和链接都容易白做。

首先从 tiddlywiki 下载单文件版文件 empty.html。

当对内容进行了修改后，点击右侧的 save changes 按钮，会弹出 save as 窗口，在窗口中选择之前的 单文件版文件 ，覆盖保存，即可将变更保存到 wiki 文件。

但是这种方式保存文件时，每次都要弹出文件选择框，比较麻烦。现在推荐的方式是 tiddlystow ，使用 file system api 将变更保存到本机文件。

tiddlywiki 的官网还提供了很多数据保存的方式，比如 TiddlyPWA

桌面和托管方案#

如果希望少碰浏览器限制，可以考虑：

• TiddlyDesktop 这类桌面壳
• Node.js 模式，把条目拆成多个独立文本
• Tiddlyhost 这类托管服务

其中 Node.js 模式更适合版本管理和自动化；Tiddlyhost 更适合想快速上线、先用起来的人。

快速上手#

更稳的入门方式，是先把 Wiki 搭起来，再慢慢加复杂功能。

可以按这个顺序来：

1. 先选一个能稳定保存的版本。
2. 写几条最基础的条目。
3. 给条目打标签。
4. 用链接把相关概念串起来。
5. 再开始尝试筛选器。

第一批内容不要追求完整，重点是把“新建、编辑、保存、恢复”这条链路跑通。TiddlyWiki 的上限很高，但它不是那种开箱就自动成型的工具。

进阶玩法#

换肤和布局#

TiddlyWiki 的界面可以改得很深。控制面板、主题和布局调整后，它能从“默认 Wiki”变成更像个人系统的东西。对于想做目录页、仪表盘、专题页的人来说，这部分很有价值。

插件生态#

插件是它的另一个大头。常见方向包括：

• Markdown 支持
• 全局搜索和替换
• 回收站和历史管理
• 目录和导出
• 复习和时间线类工具

不过插件不宜一开始就装太多。TiddlyWiki 的结构本身已经够灵活，先把条目、标签和链接用顺，再加插件，维护成本会低很多。

宏和自动化#

宏和筛选器配合起来，TiddlyWiki 可以被做成很实用的小系统，比如：

• 任务清单
• 软件评测库
• 知识索引页
• 资料归档面板

它的好处不是“看起来高级”，而是很多重复整理工作可以被模板和规则替代。越是内容积累得多，这一点越明显。

适合谁#

TiddlyWiki 很适合这些场景：

• 个人 Wiki
• 研究笔记库
• 术语表
• 软件资料库
• 写作素材库
• 可复用片段库

它尤其适合“先记一点，后面再慢慢长出来”的内容。内容量越大，标签和筛选器越能发挥作用。

需要注意什么#

TiddlyWiki 也有明显边界。

如果只是想写普通 Markdown，它会显得绕。WikiText、筛选器、系统条目这些概念，对轻量用户来说都需要一点学习成本。

如果需要团队协作、多人实时编辑或更标准的权限管理，它也不是最省心的选择。单文件模式很便携，但和 Git 配合时会有一些额外摩擦；Node.js 模式更适合长期维护，但入门门槛会高一些。

总结#

TiddlyWiki 不是一个“随便打开就能写”的笔记软件，更像一套可以不断生长的个人知识系统。它适合认真整理内容，也适合把零散条目慢慢拼成结构。

如果想找的是最直接的 Markdown 写作工具，它不是最省力的那个；如果想找的是能长期承载个人资料和知识关系的系统，它就很有意思。