笔记与自定义指令

概览

笔记用于记录实现细节、待办与踩坑，默认私有，仅自己可见。新建笔记需 Pro；已有笔记在 Free 仍可查看与改删。正文为 Markdown，须在作品侧栏创建与编辑，支持自动保存。Pro 可在「我的笔记」列表浏览全部笔记并打开完整编辑页；Free 无法进入该列表，已有笔记请从作品侧栏打开。发布作品到探索时，可在确认对话框勾选「公开笔记」；公开或仅链接可见的作品访客可通过顶栏笔记按钮或探索卡片图标，以弹窗只读查看渲染后的笔记。

在哪里写

• 账户菜单 → 我的内容 → 我的笔记（/mine/notes）：Pro 可浏览已关联作品的笔记并进入完整编辑页；Free 会看到升级说明。
• 作品工作区侧栏笔记面板：为当前作品创建与编辑关联笔记（每作品一篇）。Free 已有笔记也在此查看与改删。

元数据

编辑页除正文外还可填写：

• 标题（可选；留空时可用正文首行作为展示标题）
• 关联作品（必填；每条笔记绑定一件作品，可在笔记区显示作品链接）
• 分类（可选，便于列表筛选）
• 标签（可选，便于列表筛选）

样式与格式工具栏

编辑笔记时，正文上方有样式栏，可快速插入标题、列表、强调等 Markdown 格式；侧栏与「我的笔记」编辑页用法相同。

顶部样式栏

• 标题、待办、有序 / 无序列表
• 粗体、斜体
• 链接；插入本地图片（须配置媒体存储：Cloudinary 或 Chevereto，见下）
• 荧光笔（多色高亮选中文字）

选区快捷栏

在正文中选中一段文字后，选区附近会出现精简快捷栏，可快速加粗、斜体、行内代码或荧光笔，无需再去点顶部栏。顶部样式栏仍会保留，用于标题、列表、图片等操作。

「更多」菜单

• 宽度不够时，删除线、行内代码、代码块、表格等会收进「更多」
• 「更多」还可打开与手输相同的 @ 插入面板：作品链接、代码、预览、笔记链接

插入图片须在媒体存储配置本机图床（Cloudinary 或 Chevereto）；单张不超过 2 MB。与 Free/Pro 无关。

只读预览或访客查看笔记时不显示样式栏与选区快捷栏。

自定义指令（@ 搜索面板）

在正文行首或空格后输入完整指令，会弹出搜索面板：

1. 输入完整指令，例如 @fiddle、@note、@code 或 @preview
2. 在面板搜索框中按标题过滤作品或笔记
3. 用方向键或鼠标选择一项；@code 选中后还需选择代码范围
4. 未登录、无 Pro 或搜索失败时，面板内会显示提示

@fiddle — 引用 Fiddle

输入 @fiddle 后弹出搜索面板，按标题选择作品并插入相对路径 Markdown 链接 /f/{id}。

@fiddle
→ 在面板中选择「我的按钮」
→ [我的按钮](/f/abc123)

@note — 引用其它笔记

输入 @note 后弹出搜索面板，按标题搜索其它笔记（不含当前这篇），插入 /mine/notes/{id}/edit 链接。需已登录且具备笔记 Pro 权益。

@code — 插入 Fiddle 源码

输入 @code 后在面板中选择作品，再选择要写入正文的范围：

• HTML — 仅 HTML 面板源码
• CSS — 仅 CSS 面板源码
• JavaScript — 仅 JS 面板源码
• 全部 — 三个面板合并（体积较大）

插入内容会计入笔记 10,000 字上限；若选「全部」超限，请改选单项或使用 @fiddle 仅插链接。代码块下方会附带来源 Fiddle 链接。

@preview — 嵌入实时预览

输入 @preview 后在面板中选择作品，插入预览占位符，标题链接在下一行。阅读笔记时会将占位渲染为 sandbox iframe 预览。

{{FIDDLE_PREVIEW::id1}}

[Demo](/f/id1)

预览在编辑保存后自动加载；若 Fiddle 为私有，分享笔记前需先取消私有或改为仅链接可访问。

随作品公开

笔记默认私有。发布作品到探索（或已发布作品的「发布设置」）时，若存在关联笔记，可在对话框勾选「公开笔记」。公开或仅链接可见的作品访客可通过顶栏笔记按钮，或探索卡片上的笔记图标，以弹窗只读查看渲染后的正文（非原始 Markdown）。

如何公开作品笔记

1. 在作品编辑器侧栏写好关联笔记（每个作品至多一篇）。
2. 保存作品后，通过顶栏「分享」开启「发布」，或打开「发布设置」。
3. 在确认对话框勾选「公开笔记」（默认不勾选）。也可在「我的作品」列表发布时在同一对话框中勾选。
4. 笔记始终随作品管理、默认私有；未勾选公开时访客看不到笔记入口。作品设为私有时，公开状态会自动关闭。

访客看到什么

• 弹窗中只读渲染后的正文（含 @code 代码块，非原始 Markdown）
• 只读，无法编辑或另存为访客自己的笔记
• 不展示分类、标签等编辑页元数据

将作品保存到自己的账户不会复制其关联笔记；新副本需单独撰写或关联笔记。

「我的笔记」列表会对已公开的笔记显示「随作品公开」徽章；作品设为私有时，关联笔记的公开状态会自动关闭。可随时在「发布设置」中取消勾选以收回公开。

AI 写作（Pro + BYOK）

Pro 笔记可在关联 Fiddle 代码的基础上，用底部 AI 对话撰写或修改 Markdown（正文可为空时起稿）。须先在编辑器设置中配置 AI（BYOK）；笔记 AI 与编辑器 AI 助手共用同一套本机配置。Fiddle 侧栏笔记会自动带上当前作品代码；在「我的笔记」编辑页须填写关联 Fiddle ID。

查看 AI 助手配置说明 →

底部 AI 对话

编辑区底部固定提供 AI 对话，用自然语言描述需求——根据作品起稿教程、修改已有正文、或生成 B 站风格分段等。每次发送会基于当前全文生成/改稿，可连续多轮直到满意；生成中可点停止中断。也可粘贴截图供模型参考（需模型支持看图）；大段文字会自动变成文本附件。

1. 在底部输入要求，Enter 换行，⌘/Ctrl+Enter 发送
2. 可粘贴截图（最多 4 张），仅附图也可发送
3. 粘贴大段文字（约 400 字以上）会自动生成文本附件
4. 正文更新后可继续输入下一条要求
5. 生成中可点停止按钮中断

B 站投稿参考

笔记正文中若包含 B 站投稿参考块，顶栏可复制标题、简介与标签，便于粘贴到 B 站创作中心。

长度与其它限制

单条笔记正文上限 10,000 字符；标题 200 字符。笔记不会出现在探索页，也不会被搜索引擎索引（noindex）。

相关指南

• 编辑器 AI 助手
• 分享与链接
• 发布到探索