Brainforge Typo写下的就是看到的

图是脚本跑真应用拍的（pnpm screenshots），不是设计稿 —— 表格的列宽、公式的排版、下面那张流程图，都是产品自己算出来的。

光标进入，标记才现身 ​

这是整个交互的核心，也是它跟「左边源码 / 右边预览」最本质的区别： 平时你看到的是排好版的文字，光标走进去，那一处的 Markdown 标记就地显形供你编辑。 没有模式切换，没有第二个窗格。

光标不在里面 —— 只有排版

光标进去 —— ** 就地现身

代码、公式、图表都在同一个编辑区里 ​

代码块按语言高亮且不跟随散文折行；公式走 KaTeX；```mermaid 围栏直接出图。 全部懒加载 —— 不用这些功能的文档不会为它们付出启动成本。

现在是什么状态 ​

能用了，但还没有正式发布。 版本 0.1.0，M4.5 那一档刚做完：

GFM（表格 / 任务列表 / 删除线 / 脚注）、数学公式、Mermaid 图表、大纲面板、 命令面板、崩溃恢复、6 套主题、HTML / PDF 导出、复制为富文本、粘贴 HTML 自动转 Markdown、表格编辑、文件树、多标签页、会话恢复、设置面板、行内 HTML 渲染、 快捷键自定义 —— 都已经可用。

还没有：插件系统（M5）、用户主题目录与热加载、块级 HTML 渲染、表格拖拽调 列宽、PDF 的页眉页脚与目录页码、文件树里的重命名 / 新建 / 删除。

各里程碑「明确没做的部分」逐条写在路线图末尾的「实际偏差」里。 不藏着掖着 —— 那份清单本身就是这个项目的一部分。

想先试试 ​

还没有打过正式的 release，但每次推到 main 都会在 Actions 里产出三个平台的包。

⚠️ 这些包都没有签名。 macOS 上首次打开会被 Gatekeeper 拦下（需要右键 → 打开， 或去「系统设置 → 隐私与安全性」放行），Windows 上会被 SmartScreen 提示。 不是应用有问题，是还没配开发者证书 —— 具体缘由与解法写在 07 §6.1。

自己从源码跑更省事：

pnpm install
pnpm dev

为什么值得读它的设计文档 ​

大多数编辑器的文档在讲「有什么功能」。这里讲的是取舍，以及错在哪儿：

• 为什么选 CodeMirror 6 而不是 ProseMirror —— 富文本编辑器的 文档模型天然要求一个中间表示，而那正好跟「源码即真相」冲突；
• 为什么用两个 Markdown 解析器 —— 编辑要增量与位置精确， 导出要语义完整，一个解析器同时干这两件事只会两头不讨好；
• macOS 上 PDF 导出空白页追了七轮 CI —— 连着提出并推翻了六个结论，最后靠「把变量铺开量」定位到一个字体；
• 渲染文档里的 HTML 怎么做到不解析 HTML —— 绕开消毒器那条路，因为消毒器漏一个就是 XSS→RCE。

跟 Typora 的关系 ​

同类体验的商业产品是 Typora。本项目是一个独立实现： 不复用其代码、资源或界面素材，只借鉴「无缝实时预览」这一交互范式。 两者没有任何关联。