本 fork 正在推进 MDX 3.1.1 分阶段兼容:原生正文 + 隔离 JSX/表达式岛屿,运行时无需 Node,仍非完整 MDX。见 版本与使用边界。
重新想象 Markdown 编辑器:纯 Go 原生满帧、行云流水的触感,让每个想法都有自己的空间。
简体中文 · English
当前源码已同步上游 0.2.1。以上按钮指向上游多平台发布;本 fork 0.2.4 的 MDX 增强 macOS Apple Silicon 包见 fork Release;也可以直接从源码运行。
书写交互 · 空间与阅读 · 原生 Markdown · 功能全景 · 常用快捷键 · 性能 · 从源码运行 · 参与贡献
ArcMD 将熟悉的 Markdown 写作流带入细腻跟手的原生富文本画布。
普通 Markdown 编辑器完全使用 Go 与 MyGo Native UI 自研开发,由 Go 驱动窗口、字形排版与系统输入,不依赖 Electron 或 cgo。本 fork 的 .mdx 增强是明确例外:需要执行的 JSX/表达式区块使用隔离 WebView,编译器内嵌于 moejs,正文并非整页网页。
| ⚡ 原生正文,120 Hz 满帧 | 📄 原生 .md,来去自由 |
🎨 Arc 式空间与微交互 |
|---|---|---|
| 自研结构化文档引擎与增量排版,百万字混合长文输入 P50 仅 0.273 ms,后台落盘主线程零卡顿。 | 直接原地读写标准 .md 文件,不制造私有副本,随时与 Obsidian、VS Code、Typora 和 Git 共用同一文件夹。 |
多彩 Space 轻扫切换、全局收藏、置顶常驻标签页,配合光标滑行、即时语法编译与弹簧微动效。 |
致敬与起源
The Browser Company 宣布 Arc 步入维护模式的那天,X 上无数人都在惋惜一款如此充满审美、手感与灵魂的软件走向终局。作为一个 Arc 的长期拥趸,我不舍得那些彻底改变了我工作流的竖向侧栏、多色彩 Space、全局收藏以及安静克制的呼吸感。既然 Arc 停下了脚步,那我们就用纯 Go 与原生 UI,在文档编辑的世界里把它延续下去——献给每一个依然相信「软件应该有审美与触感」的创作者。
Note
ArcMD 仍处于早期预览阶段,不少细节仍在持续打磨迭代。如果你也喜欢这个方向,欢迎在 Issues 分享反馈与想法,或直接提交 Pull Request 一起构建。
不用在「源码」与「预览」两栏之间分心切换——你在首屏动图中看到的每一次落笔、展开与拖拽,都运行在同一张安静连贯的纸面上:
| 🪄 即时成形与反悔自由 | ∑ 行内与块级公式浮窗 |
|---|---|
输入 **粗体**、*斜体*、~~删除线~~、`代码`、-- 与 ... 即刻原地成形;括号、弯引号与 $…$ 自动配对并浮现柔和范围染色与 Tab 跳出徽章,紧接按一次 ⌫ 随时退回字面原文。 |
内嵌 KaTeX 字体原生排版 TeX 公式;行内 $…$ 在正下方浮出实时源码胶囊而不挤动行高与基线,块级公式展开「上方实时预览 + 下方源码」一体化卡片,按 Tab 或连按两次回车即可接续正文。 |
| 📐 顺滑让位与磁吸对齐 | 🖼️ 弹簧触感与零跳动媒体 |
敲下 | 表头 | 回车直接展开原生表格,折叠章节、增删块与拖拽换位的表格行列都会指数阻尼顺滑让位;拖动表格列宽、双栏中缝或分屏分隔条靠近等分时自动浮现 50% · 50% 磁吸胶囊。 |
光标跨字跨行平滑滑行,圆角胶囊选区贴合字句,任务框轻弹勾选;从访达拖入图片浮现微倾拍立得预览卡并轻弹落位,图片头部瞬时定尺寸(零布局跳动)并支持双击原位阻尼缩放灯箱。 |
每个空间对应一个本地文件夹,拥有独立的名称、图标、置顶常驻文档与阅读现场。在侧边栏双指轻扫或按 ⌃1…⌃9 即可滑入下一个空间;顶部的全局收藏跨越所有空间,点一下就在当前空间原地打开。打开「••• › 编辑主题颜色…」,可自由组合 1–3 色渐变、调节通透光影与颗粒感,或在浅色白纸与飞书风格深色纸面(#1F2023,自动重映射全部文字与高亮色调)之间平滑切换。
点击左下角的资料库图标或按 ⇧⌘L,侧边栏会平滑展开成一排空间卡片,每张卡片都以各自空间的主题色绘制,文件夹与文档随手可点开跳转。插件管理与保留 30 天的「最近删除」也集中在这里。
按 ⌘\ 收起侧边栏(窄窗口下也会自动收起),让页面安静铺满整个窗口。需要切换文档时无需重新展开:把指针移到窗口左缘,毛玻璃浮动侧边栏便轻巧滑出;悬停任意文档或文件夹即可查看实时纸面缩略图预览,移回正文即自动收回。
选中文字后点开浮动工具栏的标注面板,从 12 种手绘笔触与可选色彩中挑一种语气——圈出关键决定、划掉犹豫、给下一步画一枚箭头。每一笔都会逐笔自然绘出,并无损保存在 .md(及旧版 .arcmd)文档中。试试这篇灵感手记示例,或从自己的第一句开始。
指针移到任意段落旁,页边即淡显书签图标,点一下或按 ⌘D 即可标记。文档目录会同步列出书签(公式块自动渲染为公式缩略图),⌃⌘↑ / ⌃⌘↓ 在书签间平滑跳转,⇧⌘D 在命令栏检索所有空间的书签;书签独立存储,绝不弄脏 .md 原文。
ArcMD 直接以标准 .md Markdown 作为主格式,编辑时在后台原地自动保存到原文件(.md / .markdown / .mdx),不会在旁边生成额外的 .arcmd 副本。每篇文档都是普通的本地纯文本文件,图片存放在同级 assets/ 目录中,可随时与 Obsidian、Typora、VS Code 或 Git 无缝混用。
- 未改动段落原样保留:通过分块比对原始 Markdown(
ImportSource),未编辑的段落不会改写你原有的缩进、列表符号或链接写法。 - 扩展排版 100% 无损往返:文字颜色、背景高亮、手绘标注、五色高亮块(GitHub Alert
> [!NOTE]等)、折叠块(<details>)、跨格合并与着色表格、自定义比例双栏(data-widths)以及页面图标、封面与字数目标,通过标准 Markdown + 语义化 HTML + YAML Frontmatter 在其他阅读器中优雅降级、回到 ArcMD 完整还原。 - 平滑向下兼容:已有的旧版
.arcmd文档与历史快照仍可直接打开、编辑与迁移。
目标精确锁定 @mdx-js/mdx 3.1.1,兼容配置为 arcmd-mdx3-phase1,不是“已完整兼容 MDX 3”。本阶段已合入主线,当前正式版为 0.2.4(macOS Apple Silicon 下载),同时包含上游官方 v0.2.1;0.2.3 起具备下列 MDX 能力。保留 上游 ArcMD 的归属与原生编辑器设计。
| 能力 | 当前状态 |
|---|---|
| 普通 Markdown、代码示例;块级 JSX/fragment、Counter/Callout | 支持;普通正文仍原生,代码围栏不执行 |
独立 {expression}、IIFE 局部变量、数组/map JSX、JSX 表达式/展开属性与含组件的小写标签 |
本轮新增;仅岛屿内作用域 |
顶层段落中的行内 JSX / {expression} |
部分支持:整个受影响段落成为 WebView,不是原生行内控件;其他段落不受影响 |
| Tabs / TabItem / Accordion | 本轮新增内置组件;组件数量不代表 MDX 版本完整兼容 |
| 标题/列表/引用里的嵌套 JSX、文档级 export/共享作用域、import/组件文件、await/import.meta、跨岛屿状态 | 未支持,会拒绝或显示诊断;不读取任意文件/网络模块 |
| MDX 插件/资源与完整 CommonMark 上下文 | 部分/未支持;原生数学等功能不自动成为岛屿编译插件,外部资源仍被 CSP 限制 |
在空间、侧栏或系统打开本地 .mdx 即可;运行时无需 Node,可直接从 Finder 启动。含 MDX 的段落由嵌入式编译器处理,普通 Markdown 仍在原生编辑器中。示例:
# 原生标题
这段正文仍是原生的。
计算结果是 <strong>{6 * 7}</strong>(这一整段成为岛屿)。
{[1, 2, 3].map(n => <span key={n}>{n} </span>)}
<Counter initial={2 + 3} />完整 Tabs/Accordion 示例见 tools/mdx/example.mdx。让 agent 或外部编辑器修改 JSX,再在 ArcMD 重新载入;当前源码视图是只读导出预览。原始岛屿内容在保存时还原,渲染不会重写文件;普通 Markdown 序列化仍可能规范化格式。主题切换不重载,按内容测高;重载/切换标签页不承诺保留交互状态。成功无技术横幅,失败保留错误与干净文档的重载/重试。
开发者才需要 Node 22.12+ / 24 来生成固定资源和运行浏览器测试:
npm ci --prefix tools/mdx
npm run build --prefix tools/mdx
npm test --prefix tools/mdx
# 无窗口诊断;输出实际 compiler.version / profile / buildSha256
go run ./cmd/arcmd --jsx-check tools/mdx/example.mdx运行时不提供 Go/文件/网络桥;moejs 只执行可信编译器,文档表达式仅在 Untrusted WebView 执行,继续 hash CSP/禁网络及导航限制。编译预算为 5 秒求值、256 MiB JS 分配、512 KiB 源、32 岛屿;不是任意浏览器代码的 CPU/内存隔离。详见版本矩阵、保存/布局取舍与安全限制及可执行矩阵。矩阵区分官方语法、宿主加载和浏览器执行;预期拒绝项测试通过不等于那些功能已支持。JSDOM 不是 Mac WKWebView 实机验收,原有六项 Linux app 基线失败仍保留。
| 领域 | 内置能力 |
|---|---|
| 丰富内容块 | H1–H6 标题、嵌套列表与任务、引用、五色可换图标高亮块、17 种语言状态机增量高亮代码块(支持单块自动换行切换)、原生 Mermaid 流程图与时序图、\boldsymbol 粗体数学公式、<details> 折叠块、脚注、上下标、:sm 表情与 @ 日期/文档提及、可选中英文自动加空格。 |
| 表格、双栏与媒体 | CSV/TSV 粘贴建表、行列拖拽换位、跨格合并拆分、16 色底色、按列自然排序;可调比例双栏布局;图片无损裁剪(保留原图)与页面内 GIF 播放;框选多块批量操作与目录拖拽移动整章。 |
| 分屏、命令栏与模板 | 最多四分屏并排或拆分为独立原生窗口;零阻塞 ⌘K 命令栏(拼音/首字母与多关键词全文检索、持久化磁盘缓存、⇧⌘R 跨文档替换与一键撤销);空间模板({{date}} / {{time}} / {{weekday}} / {{title}})与 ⌥⌘T 今日笔记。 |
| 双链、专注与守护 | [[双链]] 跨空间补全、反向链接聚合与改名自动同步,#标签 全局整理;⇧⌘F 专注模式、段落余晖淡化、打字机滚动、字数目标与分屏只读锁;⇧⌘M 同步位置 Markdown 预览、纯 Go 矢量 PDF(Type 3 字形、目录书签与可点击链接) / 独立 HTML 导出;.arcmd/history 命名里程碑、字素级行内差异恢复与外部修改冲突保护。 |
| 空间问答 Agent | ⌘J 打开只读空间问答面板:不建向量索引,Agent 通过搜索、大纲、双链与按行阅读工具探索当前空间(含未保存草稿与外部空间文件),流式回答附内联来源胶囊、悬停论断高亮与滑移原文预览卡,点击直达对应内容块;支持 OpenAI / DeepSeek / OpenRouter / 本地 Ollama 等 Chat Completions 服务与终端 arcmd ask。 |
轻量核心,按需扩展:核心内置只读的空间问答 Agent,而 AI 写作改写、翻译与同步能力规划通过可选插件提供(插件也可为问答 Agent 扩展工具),让编辑器核心始终纯粹轻快。插件清单、校验安装器与宿主接口已就位,沙箱运行时与市场正在建设中,详见插件规范与路线图(英文)。
所有操作均可通过 ⌘K 命令栏触达,常用快捷键可在「设置 › 快捷键」中重新录制(Windows / Linux 下将 ⌘ 替换为 Ctrl):
| 快捷键 | 功能 | 快捷键 | 功能 |
|---|---|---|---|
| ⌘K / ⌘P | 打开命令栏与全文搜索 | ⌃1…⌃9 | 切换到第 N 个空间 |
| ⌘N / ⇧⌘N | 新建文档 / 新建文件夹 | ⇧⌘L | 打开资料库(空间 / 插件 / 最近删除) |
| ⌘\ | 收起 / 展开侧边栏 | ⌃⇧= / ⌃⇧− | 添加 / 关闭分屏面板 |
| ⇧⌘M | 富文本 ⇄ Markdown 预览(同步位置) | ⇧⌘F | 进入 / 退出专注模式 |
| ⌘F / ⇧⌘R | 页内查找替换 / 跨文档查找替换 | ⌘D / ⇧⌘D | 添加移除书签 / 全部书签列表 |
| ⌥⌘T | 打开或创建今日笔记 | ⌥⌘Y | 查看版本历史与差异恢复 |
| ⌘J | 向当前空间提问(空间问答) | ⇧⌘E | 导出矢量 PDF(含书签与链接) |
在包含 100 万字符、549 个章节、500 张表格与 9,912 个单元格的混合文档中,连续执行 100 次输入、退格与滚动操作,在三个独立新进程中测量 CPU 单帧场景构建耗时(取中位数):
| 操作 | P50 | P95 |
|---|---|---|
| ⌨️ 输入 | 0.273 ms | 0.291 ms |
| ⌫ 退格 | 0.271 ms | 0.306 ms |
| 🖱️ 滚动 | 0.548 ms | 1.132 ms |
120 Hz 显示器的每帧预算约为 8.3 ms。即使面对百万字长文,CPU 场景构建的 P95 仍低于 1.2 ms;包含事件处理的正文输入 P50 为 0.275 ms,打开查找框输入为 0.281 ms,输入法连续候选更新为 0.264 ms,单次普通输入分配量约 0.067 MB/次(分配吞吐,非常驻内存)。
测试环境与测量说明
- 硬件与环境:Apple M5 / 24 GiB,macOS 26.5.1,Go 1.27.3,MyGo v0.7.4,
CGO_ENABLED=0。 - 统计口径:通过无窗口宿主运行完整帧构建管线,测量 CPU 场景构建耗时;不包含系统事件分发、GPU 光栅化呈现与显示器延迟,因此不直接等同于端到端屏幕延迟。
- 复现方法:详见性能报告(英文)与基准测试工具(英文)。
可在 GitHub Releases 下载各平台预编译包(CI 打包工作流):
| 平台 | 架构 | 安装包 |
|---|---|---|
| macOS | Apple Silicon、Intel | .dmg(当前为临时 ad-hoc 签名,尚未公证) |
| Windows | x64 | .exe 安装程序、.zip 便携包(尚未代码签名) |
| Linux | x64、ARM64 | .deb、.tar.gz |
需要 Go 1.27.3 或更高版本(开启 GOTOOLCHAIN=auto 时会自动下载对应工具链):
git clone https://github.com/Ciao1019/ArcMD.git
cd ArcMD
CGO_ENABLED=0 go run ./cmd/arcmd使用隔离的开发目录体验(不影响个人文稿与配置):
ARCMD_HOME=/tmp/arcmd-dev CGO_ENABLED=0 go run ./cmd/arcmd构建原生应用安装包(详见构建与发布指南):
CGO_ENABLED=0 go run github.com/egoist/mygo/cmd/mygo@v0.7.4 build欢迎通过 GitHub Issues 提交问题与建议,或直接发起 Pull Request。动手前请先阅读架构说明(英文)与贡献约定。
提交改动前请确保以下检查通过:
gofmt -l .
CGO_ENABLED=0 go vet ./...
CGO_ENABLED=0 go test ./...
CGO_ENABLED=0 GOOS=linux go build ./...
CGO_ENABLED=0 GOOS=windows go build ./...若修改了界面,请运行无窗口快照测试并目检渲染结果:
ARCMD_SNAPSHOT=/tmp/arcmd-shots CGO_ENABLED=0 go test -run Snapshot ./internal/app感谢 LinuxDo 社区的支持。
ArcMD 基于 MIT License 开源。第三方字体、算法参考与许可证声明完整保留于 third_party 目录。