用法
新建笔记时复制本文件的头部(frontmatter)和章节结构,按需删减。
文件放到对应板块/子栏目目录下,例如content/01-技术教学/正手技术/正手攻球.md。
Frontmatter 约定
---
title: 笔记标题 # 必填,显示在页面和目录中
description: 一句话摘要 # 建议填,用于链接预览和搜索摘要
tags: # 建议填,格式:板块/主题,如 技术/正手
- 技术/正手
aliases: # 可选,别名,双链可用别名指向本笔记
- 别称
source: 内容来源 # 转载/提炼时填,如公众号名、期刊名;原创可省略
date: 2026-01-01 # 可选,发布或整理日期
draft: true # 草稿时填 true,不会被发布
---正文结构建议
概述
一段话讲清楚这篇笔记解决什么问题。
要点
常见误区
标题
用 callout 块突出误区、警告、提示。
相关笔记
写作约定
- 一篇笔记一个知识点,宁可拆小,不要写大而全的长文
- 多用双链:提到其他概念就链过去,目标不存在也没关系, Quartz 会标为待创建
- 标签用层级:
技术/正手、器材/底板,方便按前缀聚合 - 图片放在
content/assets/下,引用方式:![[assets/xxx.png]] - 视频放外链(B站/YouTube),不要上传视频文件到仓库