Tolaria Frontmatter字段完全参考type、status、belongs_to一次讲清【免费下载链接】tolariaDesktop app to manage markdown knowledge bases项目地址: https://gitcode.com/GitHub_Trending/to/tolariaTolaria 是一款开源的 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上级关系从属、包含、所属上下文自动计算为hashas包含关系通常是自动镜像自动镜像belongs_torelated_to横向关联松散语义连接双向生效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]]把指标挂到了职责笔记下。其他常用字段速查字段用途url保存外部规范链接date单个日期支持日期选择器编辑icon单条笔记的自定义图标aliases别名wikilink 可通过别名解析完整字段列表见官方参考文档site/reference/frontmatter-fields.md。下划线开头的系统字段以_开头的字段是系统保留字段从常规属性编辑中隐藏但仍以纯 YAML 存储可在 Raw原始 Markdown模式下检查或修改。常见系统字段包括_icon、_color、_width、_display省略为文本笔记写sheet则打开电子表格编辑器、_pinned_properties编辑器内联栏固定属性、_list_properties_display列表行中显示的属性。上手建议三步整理你的笔记库定类型为常用笔记创建类型文档type: Type配好图标与颜色补状态给可执行笔记加上status用 Inbox 快捷键CmdE/CtrlE完成整理连关系用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考