title: Joplin Rebuild Schema tags:

schema
joplin
workflow type: schema created: 2026-04-22 updated: 2026-04-22 aliases:
joplin-rebuild-schema ---

Joplin Rebuild Schema

[!note] raw/Joplin 不是普通资料堆，而是已经过初步加工的学习笔记集合。重构目标不是压缩成短摘要，而是重新组织成更适合 Obsidian 浏览、连接和复习的知识页。

目标

让每个主题都有清晰入口。
让细节进入可复习的模块页和概念页，而不是堆在导航页。
让原始资料继续只读，知识层持续可维护。
让新增来源如 raw/Documents 能沿用同一流程接入。

固定分层

来源层

raw/Joplin/
raw/Documents/
raw/<其他来源>/

这些目录一律只读，不改写原始内容。

资源引用

资源不再默认复制到 assets/
被 wiki 页面引用到的图片、PDF、附件，优先按现有仓库路径直接建立链接或嵌入。

知识层

X-Knowledge-Base/wiki/index.md
X-Knowledge-Base/wiki/log.md
X-Knowledge-Base/wiki/*.md

页面类型

主题页

作为总导航入口。
偏路径和组织，不承担大段正文细节。
内容包括：
- 主题问题
- 推荐复习顺序
- 模块地图
- 关键概念
- 常见误区
- 来源范围

模块页

承担真正可复习的正文。
重点写：
- 模块结论
- 机制、步骤、对比
- 关键例子
- 易错点
- 自测问题
- 来源

概念页

补齐跨模块复用的稳定概念。
适合写：
- 定义
- 判别边界
- 相邻概念区别
- 作用或应用
- 来源

来源页

默认不建。
只有在确实需要保留来源视角时才建 source-* 页。

拆分原则

长模块不继续堆大单页。
模块内若已经出现多个相对独立的小主题，就拆成多个子模块页。
主题页统一导航这些子模块页。

命名原则

文件名和正文标题统一使用同一种主要语言。
当前已落地主题以中文为主，因此本批页面继续保持中文一致。
不混用“英文文件名 + 中文标题”的写法。

Obsidian 规则

内部关系一律使用 [[wikilink]]
资源优先使用 ![[path/to/file]] 或 [[path/to/file]]
页面必须带 frontmatter
主题页、模块页、概念页底部都要显式列来源
来源中的 raw 路径直接写成 [[raw/...]]
不写 [[X-Knowledge-Base/raw/...]] 这类带 Vault 前缀的形式

执行流程

Ingest

读取来源目录中的总纲文件与代表文件
判断是更新已有主题、补充模块，还是新增概念页
检查是否有需要建立链接或嵌入的资源
编写或更新 wiki 页面
补交叉链接
更新 index.md
追加 log.md

Lint

检查孤立页
检查缺失回链
检查重复概念
检查已删除入口是否需要恢复
检查资源链接是否仍然有效

当前默认决策

raw/ 永远只读
主题页负责导航
模块页负责详细内容
长模块优先拆子模块
默认不建 source-* 页
index.md 与 log.md 每次都维护