内置属性:title:: icon:: alias:: 等
属性是什么
属性(Property)是 Logseq 里给块或页面加的键值对元数据。写法是 属性名:: 属性值,可以加在任何块里。
- 提交论文 deadline:: 2026-12-01 priority:: high
上面这一行的块有两个属性:deadline = 2026-12-01 和 priority = high。
属性可以被查询、被模板引用、被插件读取——它们是让知识库从「纯文本」变成「结构化数据」的关键。
内置属性速查
| 属性名 | 适用 | 作用 |
|---|---|---|
title | 页面 | 覆盖页面在 UI 上显示的标题(不改 ID) |
alias | 页面 | 添加可引用的别名(可多行) |
icon | 页面 | 设置页面图标(emoji 或图片 URL) |
template | 块 | 标记该块为模板(值为空) |
template-including-parent | 块 | 模板插入时是否包含父块 |
page-type | 页面 | 页面类型(可用来继承 icon) |
id | 块 | 块的唯一标识(只读,自动生成) |
title:: 覆盖标题
页面 ID(文件名)和显示标题可以不同:
title:: 十月份团队会议纪要
假设页面文件名叫 2026-10-13-会议.md(ID 是 2026-10-13-会议),但在 Logseq UI 里显示的标题是「十月份团队会议纪要」。引用时两个都有效:[[2026-10-13-会议]] 和设置别名后引用。
icon:: 设置图标
icon:: 📚
设置后页面在左侧树和图谱里会显示 📚 图标,快速识别。常用 emoji 或图片 URL。在 Logseq DB 版本里,icon 属性的使用更广泛——图标会出现在更多位置(右侧面板、查询结果、反向引用列表等)。
page-type:: 继承图标
page-type:: book
如果你为 book 类型设置了默认图标,所有标记 page-type:: book 的页面自动继承。这样你就不需要给每本书手动设置 icon:: 📚 了——改类型的默认图标就行。
属性 vs frontmatter
在 Markdown 格式下,页面文件的 YAML frontmatter 区域可以写属性:
---
title: 十月份团队会议纪要
alias:: 十月会议
icon:: 📝
---
这和在页面内容块里写 title:: alias:: icon:: 效果相同。两种方式都可以,Logseq 统一处理。