用法

新建笔记时复制本文件的头部(frontmatter)和章节结构,按需删减。
文件放到对应板块/子栏目目录下,例如 content/01-技术教学/正手技术/正手攻球.md

Frontmatter 约定

---
title: 笔记标题            # 必填,显示在页面和目录中
description: 一句话摘要     # 建议填,用于链接预览和搜索摘要
tags:                      # 建议填,格式:板块/主题,如 技术/正手
  - 技术/正手
aliases:                   # 可选,别名,双链可用别名指向本笔记
  - 别称
source: 内容来源            # 转载/提炼时填,如公众号名、期刊名;原创可省略
date: 2026-01-01           # 可选,发布或整理日期
draft: true                # 草稿时填 true,不会被发布
---

正文结构建议

概述

一段话讲清楚这篇笔记解决什么问题。

要点

  • 核心知识点逐条列出
  • 双链 关联到其他笔记,例如 正手攻球
  • 双链可以只写笔记名:_模板,也可以用 | 自定义显示文字

常见误区

标题

用 callout 块突出误区、警告、提示。

相关笔记

写作约定

  1. 一篇笔记一个知识点,宁可拆小,不要写大而全的长文
  2. 多用双链:提到其他概念就链过去,目标不存在也没关系, Quartz 会标为待创建
  3. 标签用层级技术/正手器材/底板,方便按前缀聚合
  4. 图片放在 content/assets/ 下,引用方式:![[assets/xxx.png]]
  5. 视频放外链(B站/YouTube),不要上传视频文件到仓库