文档日常使用

Rust · 0.1.0

标签

让标签成为笔记正文里的查找线索。

在正文中写标签

在普通 Markdown 文本中写 #reading,或 #work/review 这样的层级标签。层级标签也会包含祖先标签:work/review 会带来 work。标签从正文派生,因此跨笔记重命名需要修改原文中的相关位置;仅调整显示元数据不会改写正文。

保持一致

标签比较保留大小写和 Unicode 写法。#Work 与 #work 应视为不同标签,重复主题尽量统一写法。代码、URL 语法等不透明 Markdown 上下文不是普通标签文本。编辑、渲染和已保存笔记使用共享识别规则;不确定的写法可以在保存后检查标签列表。

少量实用标签

从少量经常使用的主题开始,不必给每个词都加标签。需要时可结合主题和处理状态,例如 #reading 与 #ideas。标签只组织检索,不控制访问;添加 #private 不会让笔记自动变成私人可见。

用小例子检查识别规则

把下例保存为私人笔记,再检查派生标签。应出现 work/review、其祖先 work,以及大小写不同的 Work;行内代码中的 literal 不应被提取。把 #work/review 改为 #work/notes 后再次保存,层级标签应随正文变化。只改标签颜色或显示元数据,不会完成这种正文替换。

A review note. #work/review #Work

Literal example: `#literal`