Obsidian的配置与美化 V2(二)——目录结构与新版笔记属性
一套 Obsidian 配置能不能长期使用,首先取决于目录和属性是否说得清楚。视觉主题可以随时换,文件命名也可以慢慢调整;如果内容类型、身份和发布状态混在一起,后面每增加一个插件都会让系统更难理解。
V2 的做法是:目录保持浅层,只表达内容类型;Properties 表达身份、状态和发布信息。
Vault 的顶层结构
00 Inbox/
10 Blog/
20 Wiki/
30 Projects/
40 Tasks/
50 Daily/
60 Temp/
70 Private/
80 Archive/
90 Assets/
99 System/
Templates/
Views/
Scripts/
这些目录各自只有一个主要职责:
| 目录 | 用途 |
|---|---|
00 Inbox |
暂时还没归类的输入 |
10 Blog |
生活、旅行和个人感受等朋友圈式公开内容 |
20 Wiki |
可持续维护的知识条目 |
30 Projects |
配置、搭建、开发、部署和维护等技术项目材料;默认私有且可主动发布 |
40 Tasks |
Deadline、Recurring、Longterm 三类任务笔记 |
50 Daily |
按日期生成、默认私有且可主动发布的日记和每日任务 |
60 Temp |
由系统创建的临时分享副本,禁止手工新建 |
70 Private |
仍在使用但绝不应发布的敏感资料 |
80 Archive |
已停止维护的历史内容和旧版本 |
90 Assets |
图片、附件等资源 |
99 System |
模板、视图、脚本和系统辅助笔记 |
数字前缀不是为了显得整齐,而是为了让常用区域稳定排序。目录名不再使用点号、下划线等多套风格,也不再用移动文件来表达“草稿”和“已发布”。
发布采用双重白名单
V2 只有四组路径和类型能够生成网站内容:
| 路径 | 必须匹配的 type |
路由 |
|---|---|---|
10 Blog |
blog |
/blog/... |
20 Wiki |
wiki |
/wiki/... |
30 Projects |
project |
/projects/... |
50 Daily |
daily |
/daily/... |
60 Temp |
temp |
/temp/<opaque-slug> |
也就是说,把一篇 type: wiki 的笔记误放进 Blog 并不会发布;把一个普通文件放进 60 Temp 也不会自动得到临时链接。路径和类型缺一不可,而缺失或写错的 publish 一律按私有处理。
所有受管理笔记共有的属性
id: 019f6665-d258-7000-8000-000000000001
type: wiki
title: 示例标题
created: 2026-07-15
updated: 2026-07-15
publish: false
publish_revision: 0
published_at:
slug: example-title
id:不随路径变化的身份
id 使用 UUIDv7,只在创建时生成一次。文件可以改名、移动,标题也可以重写,但身份不变。它解决的是“这是不是同一篇内容”,而文件名只解决“人现在怎么称呼它”。
type:内容是什么
type 必须和根目录匹配。Blog、Wiki、Project、Daily 各有自己的模板并进入发布白名单;任务也有各自类型,但永不发布。
publish:是否公开
它必须是 YAML 布尔值 true 或 false,不是字符串。所有模板默认 false,真正发布时由专门动作改成 true。
publish_revision:公开版本号
修订号必须是非负整数。它从 0 开始,只有“发布”和“更新已发布修订”会让它加 1。普通编辑不会偷偷改变公开版本,也不要手工填写 0.1 这样的值。
slug:公开地址的一部分
slug 在创建或迁移时生成。标题可以继续调整,但已经使用的 slug 不应该随意变化;修改它意味着需要考虑旧链接重定向。
不同内容类型的额外属性
Blog 需要日期和标签,可选摘要、封面、系列名与系列顺序:
date: 2026-07-15
tags:
- Obsidian
summary:
cover:
series:
series_order:
Wiki 需要分类、标签和别名:
category: Obsidian
tags: []
aliases: []
Project 需要项目状态、开始日期和标签:
project_status: active
start_date: 2026-07-15
end_date:
tags: []
summary:
cover:
project_status 只能是 active、paused、completed 或 archived。它表示项目生命周期,不会顺带发布或取消发布。
实际使用时不需要手填这些字段
属性很多,并不意味着每次都要打开 Properties 面板逐项填写。正常流程是从统一的 + New 进入:选择 Blog、Wiki、Project 或任务类型,输入标题和目标文件夹,模板自动生成 ID、日期、slug、默认状态和正文结构。
Properties 更适合在创建后检查和编辑真正需要人工判断的字段,例如标签、摘要、项目状态和结束日期。身份、默认隐私和修订号交给系统维护,既省事,也避免格式错误。
为什么不按“草稿/已发布”建文件夹
如果用文件夹表达状态,一篇文章从草稿到发布就必须移动,链接路径、附件相对位置和自动化查询都会跟着变化。V2 让文件长期留在所属内容目录,Bases 再根据 publish、project_status、日期等属性生成不同视图。
这也是新版结构最重要的变化:文件夹不再承担数据库字段的工作,Properties 也不再替代清晰的目录。
上一篇:Obsidian的配置与美化 V2(一)——从笔记软件到桌面工作系统
下一篇:Obsidian的配置与美化 V2(三)——Maple主题与四色全局配色