Logseq 中文文档 下载 App

内置属性: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 统一处理。