写作与编辑
Typora 风格混合编辑、块级引用、表格编辑器与 AI 写作辅助。
NoteFast 的编辑器基于 CodeMirror 6 构建,走 Typora 式所见即所得:语法标记在光标离开后渲染为最终形态(图片直接显示、公式直接排版、表格直接成表),不需要分屏预览。
基本约定
- 一行一块:每次回车产生一个新块(段落 / 标题 / 列表项),块是笔记的原子单位——这也是块级引用和块级检索的基础
- 软换行:段内单个换行在阅读时显示为换行(
<br>),与 Obsidian 默认行为一致 - 保存:自动保存持续进行(防丢);
⌘S保存并返回阅读,离开时自动留下一个可回退的历史版本
支持的语法
| 类型 | 说明 |
|---|---|
| 标题 | # ~ ###### |
| 表格 | GFM 管道表格,点击可打开表格网格编辑器(增删行列、单元格编辑,保存回写 GFM) |
| 代码块 | 带语法高亮与行号,右上角复制 |
| 公式 | 行内 $…$ 与块级 $$…$$(KaTeX) |
| Mermaid | ```mermaid 代码块直接渲染;点击图表可放大查看(Ctrl+滚轮缩放) |
| 图片 | 粘贴 / 拖拽 / 按钮上传;本地内容寻址存储,可选自动上传图床 |
| 任务列表 | GFM - [ ] / - [x] |
图片处理
粘贴或拖入图片即自动上传到本地知识库(asset:<sha256> 引用,内容寻址去重)。配置图床后,本地保存的同时异步上传到图床,导出与分享使用外链。上传失败静默降级本地——不阻塞写作、不丢图。
AI 写作
所有 AI 写作走 OpenAI 兼容接口,未配置时功能自动隐藏(见配置):
- Ghost-text 续写:
⌘Enter唤起,灰色幽灵文本随光标出现,Tab接受、Esc忽略 - 选区改写:选中一段文字 → 「让 AI 改写」→ 按指令重写,先预览再决定是否替换
- 标题建议:根据正文自动生成标题,点击应用
块级操作(阅读态)
阅读态下鼠标悬停任意段落可:
- 复制块链接——把某个段落作为可引用单元分享(站内跳转直达该块)
- 就此提问——选中文字让 AI 围绕这段回答,不打断阅读流
历史版本
右侧「历史」面板记录文档的版本点:手动保存、离开编辑时自动记录(连续编辑中的自动保存不产生版本点,避免刷屏)。任意版本点可预览、可回退;回退本身也会留下一条记录,可以再退回来。