思源笔记上手指南3 步把散落各处的笔记变成流动的知识库【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan如果你的笔记散落在 Markdown 文件、浏览器收藏夹和手机备忘录里翻来翻去却串不成一张网可以试试思源笔记——一个开源、隐私优先、自托管的知识工作空间它把每段内容都拆成可独立引用的块靠块级编辑和双向链接让知识之间自己长出路来数据默认全部存在你自己的电脑上。初体验装完第一天就能干的事第一次打开思源笔记界面上最显眼的就是三栏左边是文档树中间是编辑区右边是反链、引用和图谱面板。别急着学快捷键先把这三件事做完你就跨过了第一道门槛。建一个笔记本写下第一篇文档新建笔记本 → 在笔记本下新建文档 → 敲回车开始写。和印象笔记这类工具不同思源里的文档本身也是一个块标题、段落、列表、代码块统统是块。想感受这一点把光标放在任意一行按Ctrl/Mac 上是Cmd/调出块菜单把一行普通文字转成任务清单或引用块再拖拽左侧的块标≡图标换位置——你会发现内容不是复制粘贴而是整块搬过去原文里不留痕迹。官方自带了一份图文指南卡在哪儿可以对照着看app/guide/。把旧笔记导进来有现存的 Markdown 文件直接在文档树或笔记本图标上右键就能批量导入.md文件按目录结构变成一个个文档。反过来右上角菜单里的导出支持把文档导出成 Markdown、PDF、HTML 等格式支持范围见 docs/API.zh-CN.md 中列出的接口和格式换工具时数据带得走这一点先记着后面迁移时会用到。养成习惯一周内值得固化的工作流用块引用代替复制粘贴一周内你会遇到的第一个真问题同一段话要出现在两篇文档里改一处另一处就过时了。思源的做法是引用而不是复制——输入[[会弹出引用搜索框输入关键词后选中目标块当前文档里就插入了一块活的引用被引用块改字、移动引用处实时同步。配套的还有双向链接右侧反链面板会自动列出所有引用当前块的位置图谱面板则把这些关联画成网状。写到第二周你会明显感觉到知识不再是躺在孤立的文档里而是被引用关系串起来——这是它和纯 Markdown 文件最大的体验差异。让数据库视图接住清单类内容书单课程表项目任务这类条目化内容用表格块记着记着就会失控。思源的数据库视图可以把它们变成可筛选、可统计的结构化数据字段即属性每行一条记录支持表格、卡片、看板多种展示方式还能做汇总统计比如按作者统计作品数量字段公式写在 docs/SY-FORMAT.zh-CN.md 的模板说明里有例子。用法很直接在块菜单里新建数据库定义好字段如作者、类型、状态然后每行记录本身就是一段可以引用、可以排序的块。读完三本书已读状态的筛选结果就是你的阅读年报。用模板和片段固定记录格式每天写晨间日记、每次开会记纪要格式总是一样的何必每次都手敲在设置 → 模板片段里存一段带变量的模板比如自动插入当天日期、{{.Title}}文档标题新建文档时一键套用。片段则解决更小的重复常用的一句话、一段代码、一个引用格式存成片段后在编辑器里输入触发词就能呼出。这两样东西花半小时配好后面每天能省十分钟。进阶玩法一个月后的深度用法多设备同步与自托管部署桌面端和移动端装好客户端后在设置里登录同一账号官方云同步会员功能端到端加密会把数据自动推到另一端。如果你想要完全自己掌控思源支持 Docker 自托管——把数据仓库放在自己的服务器或 NAS 上客户端连上去即可启动命令只有这么一段docker run -d \ -v ./siyuan-data:/siyuan/workspace \ -p 6806:6806 \ -e SIYUAN_LANGzh-CN \ b3log/siyuan \ serve --workspace/siyuan/workspace --accessAuthCode你的访问码--accessAuthCode是网页端的锁屏密码自托管时务必设置挂载目录的读写权限也建议先确认仓库里的 Dockerfile 和 README 中有完整参数说明。数据历史删错了能救回来用思源一个月后最让人安心的功能是数据历史它每隔一段时间自动给工作区打快照文件历史存在workspace/history/另有加密压缩的数据快照误删、误改都可以从历史里回滚。界面在设置 → 数据历史右侧面板能直接看到每次快照和回滚点。配合定期把整个 workspace 目录打包备份它就是一个普通文件夹结构见 docs/WORKSPACE.zh-CN.md官方历史 手动备份双保险比大多数笔记工具都稳。文档块和标题块互换重构层级不用重写写到后期文档内部结构经常需要调整想把一篇长文档拆成子文档或者反过来把几个章节合并。思源的文档与标题块互换就是干这个的——把文档拖进编辑器里会变成标题块层级自动按插入位置重算把标题块拖回文档树则变成独立文档且已有的引用关系不会断。主题定制按自己的口味调界面界面不满意思源的主题系统基于 CSS 变量改几个色值就能换一套皮肤自带昼/夜两套主题app/appearance/themes/下各有一份样式和配置。想深入改参考 app/guide/ 里自定义外观一节用浏览器开发者工具边试边改。常见坑与应对用第三方同步盘同步 workspace 文件夹是踩坑率最高的操作。思源的数据包含 SQLite 索引和大量小文件网盘同步容易产生冲突文件甚至索引损坏官方明确不推荐多端需求请用官方云同步或自建服务器备份则走定期打包整个 workspace的路子。工作区丢进 Git 却忽略了data和repo目录会让提交记录里塞满二进制索引。用 Git 管版本时.gitignore里至少排除workspace/data/和workspace/repo/只提交.sy文档和data配置以外的内容。单篇文档无限膨胀。一篇文档塞进上千个块后编辑和渲染都会变慢。经验法则是一个文档只装一个主题超长了就用文档转标题块拆子文档主题再大的话拆成独立笔记本。自托管没设访问码等于把整个笔记库裸奔在网络上。--accessAuthCode或账号锁屏密码二选一必须设反代部署时再配上 HTTPS。今天就可以做的三步装好客户端新建一个学习笔记本把最近在读的一本书的目录导入进来挑三五个核心概念各建一段用[[块引用互相挂上看看右侧反链和图谱长什么样进设置确认数据历史的快照间隔再把 workspace 目录整体打包一份存到另一个磁盘。做完这三步你就有了第一个会自己长链接的知识库——剩下的交给每天写进去的内容。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 思源笔记上手指南：3 步把散落各处的笔记变成流动的知识库
思源笔记上手指南3 步把散落各处的笔记变成流动的知识库【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan如果你的笔记散落在 Markdown 文件、浏览器收藏夹和手机备忘录里翻来翻去却串不成一张网可以试试思源笔记——一个开源、隐私优先、自托管的知识工作空间它把每段内容都拆成可独立引用的块靠块级编辑和双向链接让知识之间自己长出路来数据默认全部存在你自己的电脑上。初体验装完第一天就能干的事第一次打开思源笔记界面上最显眼的就是三栏左边是文档树中间是编辑区右边是反链、引用和图谱面板。别急着学快捷键先把这三件事做完你就跨过了第一道门槛。建一个笔记本写下第一篇文档新建笔记本 → 在笔记本下新建文档 → 敲回车开始写。和印象笔记这类工具不同思源里的文档本身也是一个块标题、段落、列表、代码块统统是块。想感受这一点把光标放在任意一行按Ctrl/Mac 上是Cmd/调出块菜单把一行普通文字转成任务清单或引用块再拖拽左侧的块标≡图标换位置——你会发现内容不是复制粘贴而是整块搬过去原文里不留痕迹。官方自带了一份图文指南卡在哪儿可以对照着看app/guide/。把旧笔记导进来有现存的 Markdown 文件直接在文档树或笔记本图标上右键就能批量导入.md文件按目录结构变成一个个文档。反过来右上角菜单里的导出支持把文档导出成 Markdown、PDF、HTML 等格式支持范围见 docs/API.zh-CN.md 中列出的接口和格式换工具时数据带得走这一点先记着后面迁移时会用到。养成习惯一周内值得固化的工作流用块引用代替复制粘贴一周内你会遇到的第一个真问题同一段话要出现在两篇文档里改一处另一处就过时了。思源的做法是引用而不是复制——输入[[会弹出引用搜索框输入关键词后选中目标块当前文档里就插入了一块活的引用被引用块改字、移动引用处实时同步。配套的还有双向链接右侧反链面板会自动列出所有引用当前块的位置图谱面板则把这些关联画成网状。写到第二周你会明显感觉到知识不再是躺在孤立的文档里而是被引用关系串起来——这是它和纯 Markdown 文件最大的体验差异。让数据库视图接住清单类内容书单课程表项目任务这类条目化内容用表格块记着记着就会失控。思源的数据库视图可以把它们变成可筛选、可统计的结构化数据字段即属性每行一条记录支持表格、卡片、看板多种展示方式还能做汇总统计比如按作者统计作品数量字段公式写在 docs/SY-FORMAT.zh-CN.md 的模板说明里有例子。用法很直接在块菜单里新建数据库定义好字段如作者、类型、状态然后每行记录本身就是一段可以引用、可以排序的块。读完三本书已读状态的筛选结果就是你的阅读年报。用模板和片段固定记录格式每天写晨间日记、每次开会记纪要格式总是一样的何必每次都手敲在设置 → 模板片段里存一段带变量的模板比如自动插入当天日期、{{.Title}}文档标题新建文档时一键套用。片段则解决更小的重复常用的一句话、一段代码、一个引用格式存成片段后在编辑器里输入触发词就能呼出。这两样东西花半小时配好后面每天能省十分钟。进阶玩法一个月后的深度用法多设备同步与自托管部署桌面端和移动端装好客户端后在设置里登录同一账号官方云同步会员功能端到端加密会把数据自动推到另一端。如果你想要完全自己掌控思源支持 Docker 自托管——把数据仓库放在自己的服务器或 NAS 上客户端连上去即可启动命令只有这么一段docker run -d \ -v ./siyuan-data:/siyuan/workspace \ -p 6806:6806 \ -e SIYUAN_LANGzh-CN \ b3log/siyuan \ serve --workspace/siyuan/workspace --accessAuthCode你的访问码--accessAuthCode是网页端的锁屏密码自托管时务必设置挂载目录的读写权限也建议先确认仓库里的 Dockerfile 和 README 中有完整参数说明。数据历史删错了能救回来用思源一个月后最让人安心的功能是数据历史它每隔一段时间自动给工作区打快照文件历史存在workspace/history/另有加密压缩的数据快照误删、误改都可以从历史里回滚。界面在设置 → 数据历史右侧面板能直接看到每次快照和回滚点。配合定期把整个 workspace 目录打包备份它就是一个普通文件夹结构见 docs/WORKSPACE.zh-CN.md官方历史 手动备份双保险比大多数笔记工具都稳。文档块和标题块互换重构层级不用重写写到后期文档内部结构经常需要调整想把一篇长文档拆成子文档或者反过来把几个章节合并。思源的文档与标题块互换就是干这个的——把文档拖进编辑器里会变成标题块层级自动按插入位置重算把标题块拖回文档树则变成独立文档且已有的引用关系不会断。主题定制按自己的口味调界面界面不满意思源的主题系统基于 CSS 变量改几个色值就能换一套皮肤自带昼/夜两套主题app/appearance/themes/下各有一份样式和配置。想深入改参考 app/guide/ 里自定义外观一节用浏览器开发者工具边试边改。常见坑与应对用第三方同步盘同步 workspace 文件夹是踩坑率最高的操作。思源的数据包含 SQLite 索引和大量小文件网盘同步容易产生冲突文件甚至索引损坏官方明确不推荐多端需求请用官方云同步或自建服务器备份则走定期打包整个 workspace的路子。工作区丢进 Git 却忽略了data和repo目录会让提交记录里塞满二进制索引。用 Git 管版本时.gitignore里至少排除workspace/data/和workspace/repo/只提交.sy文档和data配置以外的内容。单篇文档无限膨胀。一篇文档塞进上千个块后编辑和渲染都会变慢。经验法则是一个文档只装一个主题超长了就用文档转标题块拆子文档主题再大的话拆成独立笔记本。自托管没设访问码等于把整个笔记库裸奔在网络上。--accessAuthCode或账号锁屏密码二选一必须设反代部署时再配上 HTTPS。今天就可以做的三步装好客户端新建一个学习笔记本把最近在读的一本书的目录导入进来挑三五个核心概念各建一段用[[块引用互相挂上看看右侧反链和图谱长什么样进设置确认数据历史的快照间隔再把 workspace 目录整体打包一份存到另一个磁盘。做完这三步你就有了第一个会自己长链接的知识库——剩下的交给每天写进去的内容。【免费下载链接】siyuanAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间让人与智能体在此协作项目地址: https://gitcode.com/GitHub_Trending/si/siyuan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考