写作与编辑

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 围绕这段回答,不打断阅读流

历史版本

右侧「历史」面板记录文档的版本点:手动保存、离开编辑时自动记录(连续编辑中的自动保存不产生版本点,避免刷屏)。任意版本点可预览、可回退;回退本身也会留下一条记录,可以再退回来。