企业官网建设流程全解析

本地存储SiYuan：块级编辑与知识图谱怎么上手

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan

SiYuan 是一款完全开源、本地优先的知识管理工具：数据默认存在你自己的电脑上，编辑器以"内容块"为单位组织笔记，还能自动生成知识图谱。它适合想把学习笔记、项目文档收进一个个人数字笔记库、又担心云端依赖的人。比如整理一门课的笔记时，你希望把某一章拆成新文档、让前后知识点互相引用，SiYuan 就是为此设计的。

它和传统笔记工具的区别

内容块：传统编辑器做不到的操作

传统编辑器里，段落只是"一行行文字"。想把某段内容整体挪到另一份文档，只能复制粘贴，原来的引用、回链全断了。SiYuan 的做法不一样：

• 每一段文字、表格、代码都是独立的内容块，块有唯一标识，可以单独移动、复制、引用
• 文档块可以直接转成标题块，已有引用关系不会断
• 你不需要手动维护目录，层级由块本身撑起来

图：SiYuan 的内容块编辑界面，左侧文档树、中间块级编辑器、右侧知识图谱

知识图谱是怎么自动长出来的

传统工具里"知识图谱"往往要手动打标签、建关系。SiYuan 的图谱是自动的：你在文档里引用了另一个块，被引用的块就多了回链，图谱里多一条边。写笔记的过程就是在织网，图越写越密。对做知识管理的人来说，这是"顺手的副产品"，而不是额外维护的工作。

本地数据怎么存、怎么兜底

SiYuan 完全开源，代码托管在仓库中，任何人可以审查。对你的意义是：笔记以本地文件形式落在你的硬盘上，你拥有完整的离线副本，不存在"服务停运、数据拿不回来"的剧本。

兜底机制分两层：

• workspace/history/保存文件历史，每 10 分钟为有改动的文档生成一份，误删、改坏后可以直接复制回来手动恢复
• workspace/repo/保存加密压缩的数据快照，用于本地恢复与云同步

图：SiYuan 的数据历史界面，文件历史与数据快照各司其职

换句话说，"数据在自己手里"不是一句口号：历史文件是明文可读的，你随时可以打开看一眼。

从打开到写下的最短路径

把仓库拉到本地

运行一条命令，仓库连同示例工作区就落到你的目录里：

git clone https://link.gitcode.com/i/4c2bc962ed3d391673b424cda89447d7

切一个顺眼的主题

在设置的"外观"里可以切换明暗主题，也可以从内置封面挑一个；想再深一点，用开发者工具改样式。官方指南里就有一节《Custom Appearance》，演示了怎么自定义界面，路径见 app/guide/。

图：通过开发者工具自定义 SiYuan 界面样式

建笔记本，用 / 唤起内容菜单

打开后点左侧文档树的"+"新建笔记本，再在笔记本下新建文档。在编辑器里输入/，会弹出内容菜单，从这里可以插入图片、表格、代码块等任意块。

把块拖成文档

想建层级结构时，把某个文档块拖到目标标题块下方，它会转换成一个标题块，原块里的内容跟着走，原有引用不失效。官方文档对这两种转换的说明在 docs/。

图：把文档块转换为标题块的官方文档说明

进阶玩法（按需选读）

外观定制主要动appearance/themes/下的 CSS，改完即生效，适合有审美洁癖的人。功能扩展走插件机制，仓库里保留了插件相关的实现与示例，感兴趣可以翻一翻，不想折腾也不影响日常使用。

现在就试一次

如果你正被"笔记散落在云端、想不起存在哪"困扰，花十分钟把仓库拉到本地、建一个笔记本、写下第一块内容，比看任何评测都管用。

【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间，让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan