企业官网建设流程全解析

Tolaria Frontmatter字段完全参考：type、status、belongs_to一次讲清

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria

Tolaria 是一款开源的 Markdown 知识库管理桌面应用，它用 YAML Frontmatter 字段（如 type、status、belongs_to）为笔记提供类型、状态和关系结构。本文是面向新手的 Tolaria Frontmatter 字段完全参考：不用背 schema，只需理解几个核心字段和命名约定，就能让笔记库从"一堆文档"变成可导航的知识图谱。

Tolaria Frontmatter字段：笔记头部的YAML frontmatter结构

一分钟理解 Frontmatter 在 Tolaria 中的作用

Tolaria 的理念是文件即数据：每条笔记就是一个 Markdown 文件，标题取自第一个 H1 标题，而结构化信息写在文件顶部的 YAML Frontmatter 里。官方文档把字段定义为"约定而非强制 schema"——你可以只写type，也可以全部用上，Tolaria 都能识别。

type：给笔记定"物种"

type:字段声明这条笔记是什么实体：Project（项目）、Person（人物）、Topic（主题）、Procedure（流程）、Event（事件），或你自己创建的任何分类。

--- type: Project status: Done ---

三个要点：

• Tolaria 不会根据文件夹位置推断类型，把文件挪到别的文件夹不会改变type。官方推荐"用类型而非文件夹分组"，因为类型比文件路径语义更强。
• 类型可以在类型文档（Type Document）中定义：一个带type: Type的 Markdown 笔记，通过_icon、_color、_sidebar_label、_order控制侧边栏图标、颜色、名称和排序，还能定义新建该类型笔记时的默认字段（比如项目类型默认status: Active）。
• 历史背景：早期版本曾用Is A:字段，现已统一为标准的type:，旧字段仅作为兼容别名保留。

想动手看一个真实例子，可以看演示库中的项目笔记：demo-vault-v2/25q1-laputa-v1.md。

status：追踪生命周期状态

status:字段记录笔记所处的生命周期阶段，常见取值如 Active（进行中）、Done（完成）、Blocked（受阻）。它适合用在"可执行"类笔记上——项目、任务、待办流程等。

在 Inbox（收件箱）整理流程中，官方建议对可执行笔记补上status，再配合belongs_to/related_to建立连接。你不需要穷举固定枚举，status只是普通字符串字段，团队或个人可以自定义词汇表，但保持全库一致是关键。

belongs_to：一次讲清关系型字段

Tolaria 支持三类默认关系字段，值指向其他笔记的 wikilink，可以写单条，也可以写成数组：

belongs_to: - "[[25q1]]" related_to: - "[[documentation]]"

亮点在于自动反向计算：如果 A 笔记写belongs_to: [[B]]，B 笔记的关系面板会自动出现 A 在它的has列表下——无需手写反向链接。这些关系会出现在 Properties 面板和 Neighborhood（邻域）模式里，笔记列表会围绕当前笔记展开成图谱视图。

另外，Tolaria 能动态识别自定义关系字段：任何包含 wikilink 的字段（比如blocked_by、owner）都会被视为关系。例如演示库中的指标笔记 demo-vault-v2/measure-sponsorship-mrr.md 就用belongs_to: "[[responsibility-sponsorships]]"把指标挂到了职责笔记下。

其他常用字段速查

完整字段列表见官方参考文档：site/reference/frontmatter-fields.md。

下划线开头的系统字段

以_开头的字段是系统保留字段，从常规属性编辑中隐藏，但仍以纯 YAML 存储，可在 Raw（原始 Markdown）模式下检查或修改。常见系统字段包括_icon、_color、_width、_display（省略为文本笔记，写sheet则打开电子表格编辑器）、_pinned_properties（编辑器内联栏固定属性）、_list_properties_display（列表行中显示的属性）。

上手建议：三步整理你的笔记库

1. 定类型：为常用笔记创建类型文档（type: Type），配好图标与颜色；
2. 补状态：给可执行笔记加上status，用 Inbox 快捷键Cmd+E/Ctrl+E完成整理；
3. 连关系：用belongs_to和related_to把笔记连成图谱，在 Neighborhood 模式中查看。

官方整理清单见 site/guides/organize-inbox.md，类型机制详解见 site/concepts/types.md，关系机制详解见 site/concepts/relationships.md。

记住一个原则：不要为结构化而结构化——只添加那些能帮你未来导航、筛选和回顾的字段。掌握 type、status、belongs_to 这三个核心字段，你就已经用上了 Tolaria 大部分的组织能力 🎯。

【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolaria