十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Lumen Frontmatter元数据手册:几行YAML解锁书封封面、生日倒计时等6大隐藏功能

Lumen Frontmatter元数据手册:几行YAML解锁书封封面、生日倒计时等6大隐藏功能 Lumen Frontmatter元数据手册几行YAML解锁书封封面、生日倒计时等6大隐藏功能【免费下载链接】lumenA free, open-source note-taking app that syncs with markdown files in your GitHub repository项目地址: https://gitcode.com/gh_mirrors/lumen1/lumenLumen 是一款免费开源的 Markdown 笔记应用能将笔记实时同步到你 GitHub 仓库中的 Markdown 文件里。而它最容易被忽视的隐藏武器就是笔记顶部的Frontmatter 元数据——只需几行 YAML就能解锁书封封面、生日倒计时、自动模板等 6 大实用功能。什么是 Frontmatter一分钟上手 Frontmatter 是写在 Markdown 文件最顶部、被两行---包裹的键值对区域采用 YAML 语法。Lumen 会自动解析它并为笔记界面开小灶--- isbn: 978-1542866507 birthday: 1990-05-20 tags: [阅读, 人物] ---解析逻辑位于 src/utils/frontmatter.ts官方文档的键值说明见 docs/metadata.md。Frontmatter 支持任意合法 YAML 键值对下面是 Lumen 特别认识的 6 个键。功能一isbn 一键召唤书封封面 在读书笔记里写上 ISBN-10 或 ISBN-13Lumen 就会自动从开放图书库拉取封面把书封图和链接展示在笔记标题下方--- isbn: 978-1542866507 read: true ---书封渲染逻辑在 src/components/markdown.tsx零配置、零插图读书笔记瞬间有了图书馆感。功能二birthday 生日倒计时 ⏳给家人的笔记加上birthdayLumen 会自动计算并展示距离下一个生日还有多久同时把生日当天标记到日历中--- birthday: 05-20 # 也可写完整格式 1990-05-20 ---倒计时日期由 src/utils/parse-note.ts 计算得出。再也不用担心忘记妈妈的生日。功能三tags 给笔记打标签 ️在 Frontmatter 里直接声明标签效果与正文中的#tag语法完全等价但更整洁、更适合长笔记--- tags: - 读书 - 灵感 ---支持嵌套标签如工作/项目A会自动展开父级标签解析实现见 src/utils/parse-note.ts。功能四template 把笔记变成可复用模板 在 frontmatter 中加入template配置这条笔记就摇身一变成为模板。之后在任何笔记里输入/即可调出模板列表一键插入--- template: name: Book author: isbn: --- # #book模板还支持 EJS 变量如% date %自动填入当天日期和输入提示完整玩法见 docs/templates.md模板数据结构定义在 src/schema.ts。功能五image 自定义分享封面 ️Lumen 分享笔记时会生成预览卡片。用image指定一张图就能掌控别人看到的门面——可以是图片地址也可以是 Markdown 图片语法--- image: ![](https://example.com/cover.jpg) ---分享页面读取该键值的逻辑位于 api/share/[...path].ts。功能六pinned 把重要笔记钉在顶部 想置顶一条笔记加一行pinned: true即可它会出现在笔记列表顶部方便随时找回来--- pinned: true ---解析见 src/utils/parse-note.ts。注意pinned、updated_at、font、width等属于保留键只在后台生效、不会在属性面板中显示见 src/utils/frontmatter.ts。彩蛋更多实用键值对 键作用alias为笔记设置链接别名被引用时显示这个别名url为笔记标题绑定链接并用作favicon图标见 src/components/note-favicon.tsxgithub填写 GitHub 用户名在笔记头部显示头像date等日期键任意日期值都会自动关联到日历视图updated_at记录笔记最后更新时间保留键不显示小贴士Frontmatter 中的日期、#标签、[[wiki链接]]同样会被解析并建立关联所以它不仅是属性区更是一张关系网的起点。写在最后Frontmatter 就是 Lumen 的超能力开关几行 YAML 换来书封、倒计时、模板、标签和置顶。把这些隐藏键值对加入你的笔记模板GitHub 里的纯文本仓库会立刻变成一个功能丰富的第二大脑 ✨【免费下载链接】lumenA free, open-source note-taking app that syncs with markdown files in your GitHub repository项目地址: https://gitcode.com/gh_mirrors/lumen1/lumen创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表