用途:在 Hyday 中创建与编辑笔记。Hyday 将每条笔记存为磁盘上的普通 .md 文件,应用会自动扫描更新。本技能覆盖 Hyday 在标准 Markdown 之上的扩展语法,假定已知 CommonMark + GFM。
定位库根目录:先执行 hyday-vault-layout 的 Step 0。macOS 读取 ~/Library/Application Support/Hyday/settings.json,Windows 读取 %APPDATA%\Hyday\settings.json,取 journalPath 字段。不要猜测路径,不要写入 ~/Documents/Hyday,仅当配置读取失败才询问用户。
创建流程:选择以 .md 结尾的描述性文件名;避免形如 YYYY-MM-DD.md 的名称,除非确为日志条目(Hyday 会按文件名自动识别为 journal)。文件顶部用 --- 包裹 YAML frontmatter,字符串值一律用双引号。type 可取 article、card、img、link、video,省略默认为 article;日志文件不设 type。正文用 Markdown,可按需加入 #tag、@(Label)、[[note-id]],保存后数秒内重新索引。
Frontmatter 字段:title(省略则用文件名)、type、tags(与内联 #标签 合并)、pinned、archived、createdAt、lastModified(格式 YYYY-MM-DD HH:mm:ss)、sourceUrl、sourceTitle、sourceDomain、sourceDescription、sourceImage、sourceEmbedUrl、capturedAt。字符串须双引号,内部双引号转义为 ",标签项用短横线形式并逐项加引号。
笔记类型:article 长文/会议记录(默认);card 短小原子想法;img 以图为主,首图为封面;link 保存网页,设 sourceUrl、sourceTitle、sourceDomain;video 保存视频,设 sourceUrl 与 sourceEmbedUrl。journal 不写进 frontmatter,由文件名推断。
内联标签:如 #reading、#books/non-fiction(斜杠建层级)、#project-alpha。须以字母开头,可含字母、数字、_、-、/。围栏代码块与行内代码中的 # 不会被解析。内联实体语法为 @(Label),标签可含空格,不能含 )。旧语法 @{Label} 仍被接受,保存时会迁移。@(...) 前必须是空白、CJK 标点或行首。
反向链接:[[2026-05-17]]、[[笔记本标题]]、[[note-id|显示文本]]。按标题再按文件名匹配,日志用 YYYY-MM-DD 日期;多个匹配取最近修改者。不支持标题或块锚点。
编辑器还支持 GFM 表格、任务列表、删除线、围栏代码块、行内与块级数学公式、```mermaid 图、Obsidian/GitHub 风格 callout(note、tip、warning、info、important、caution、success、failure、question、example、quote、todo)。
限制与校验:写完后检查 frontmatter 为合法 YAML 且字符串加引号、type 合法且不写 journal、标签规则合规、实体用 @() 形式、反向链接指向存在或计划创建的笔记、日志文件名匹配 YYYY-MM-DD.md 或 YYYY.MM.DD.md。代码块内标签与实体不解析。相关技能:hyday-vault-layout、hyday-lifelog、hyday-whiteboard。未提供的收费、平台或价格信息暂未说明。