小而美的桌面 Markdown 写作与笔记应用
写作、排版、AI 辅助与发布,装进一个十几 MB 的安装包
小
- 安装包小:Windows 与 Linux 安装包约 12 MB,macOS 通用包约 23 MB,支持应用内一键更新。
- 数据在本地:任意文件夹即笔记库,文件均为标准 Markdown,可随时用其他工具打开、同步或纳入 Git。
- 不多要一把钥匙:AI 写作复用本机已登录的 Agent(Claude Code、Codex、Gemini CLI 等),无需额外的 API Key。
- 不多装一个软件:PDF 按编辑区样式直接生成,无需安装 LaTeX 或打印驱动。
美
- 排版所见即所得:内置 15 种排版主题,也可导入 Typora 主题作为浅色或深色外观。
- 一键出稿:复制带排版的富文本到任意编辑器,或直接发布到微信公众号草稿箱;公式自动转 SVG,Mermaid 图表自动转图片。
- AI 改动可审阅:Agent 的每处修改都以段落级 + 词级差异呈现,逐处接受或拒绝后才会生效。
- 安静地写:专注模式、打字机模式、三档编辑区宽度,以及与 Typora 一致的段落快捷键。
- 以任意本地文件夹作为笔记库,文件均为标准
.md格式,不含笔记的文件夹不显示 - 打开笔记库以外的文件时,侧栏自动切换到其所在文件夹;保留最近打开的文件夹
- 支持多个独立窗口(
Ctrl+Shift+N/⌘⇧N),文件右键可选择「在新窗口打开」;在「设置 → 通用设置 → 窗口」选择打开文件使用当前窗口或新窗口、打开不同工作区时覆盖或新建窗口(跨工作区时优先使用工作区设置)。文档、草稿与 AI 会话按窗口隔离,已打开的文件会切换到对应窗口。 - 新建、重命名、移到废纸篓、在文件管理器中显示;编辑内容自动保存,未命名草稿也会自动持久化
- 可在「设置 → 通用设置 → 窗口」开启文档标签页(默认关闭),在同一窗口快速切换文档。切换、关闭前自动保存;支持 Ctrl+Tab / Ctrl+Shift+Tab 切换、Ctrl+W(macOS 为 ⌘W)关闭。关闭最后一个标签后显示内置示例,可另存为编辑。
- 基于 Tiptap 3 的所见即所得编辑,支持 Markdown 源码模式(
⌘/)随时切换 - 标题、列表、任务列表、引用、高亮、上下标、链接、图片
- 表格(行列工具条)、代码块(语言选择、语法高亮、一键复制、格式化)
- 数学公式(KaTeX)与 Mermaid 图表(实时渲染,可复制为图片或导出 PNG / SVG)
/命令菜单、选区格式工具栏、顶部快捷操作栏(可在设置中关闭)、查找替换- 文档开头 YAML 元信息(front matter)的折叠显示与编辑(套用排版主题时隐藏)
- 大纲导航、专注模式、打字机模式,Typora 风格快捷键;在「设置 → 通用设置 → 窗口 → 大纲位置」选择默认的「标签切换」,或在文件列表下方同时显示当前文档大纲。
- 内置 15 种排版主题,直接作用于编辑区;可调整字号、段距,可把外链转为文末脚注
- 编辑区宽度提供「标准 / 宽屏 / 铺满」三种预设
- 「原生样式」可设置字体、字号、行距与段落间距,发布时仍应用所选排版主题
- 「设置 → 编辑器 → 原生样式」支持搜索本机字体、调整正文字重、独立设置代码与源码字体,提供实时预览与恢复默认;自定义项覆盖编辑区主题并用于 PDF,发布仍使用排版配置
- 浅色 / 深色 / 跟随系统外观,可导入 Typora 主题分别作为浅色或深色主题
- 经典或红绿灯窗口按钮;关闭到后台(Windows / Linux 托盘菜单可自定义)
内置排版主题:暖陶米白、极简留白、暗夜深色、简洁蓝、优雅棕、活力红、琥珀橙、清新绿、健康绿、杂志红、复古纸、海盐青、科技蓝、报刊体、暖阳红。
- 粘贴、拖拽或命令插入;可上传至 PicGo / PicList 图床,或保存到文档同级的
assets目录 - 图片操作条可把本地图片上传到图床、把网络图片存到本地、替换图片、编辑说明文字
- AI 生图,支持 OpenAI、豆包、通义万相、智谱、硅基流动及 OpenAI 兼容接口
- 通过 Agent Client Protocol(ACP)连接本机 AI Agent,无需 API Key
- 对话助手、按风格从话题生成大纲并写成新文档、选区内联改写与续写、自然语言生成公式
- Agent 的所有修改须经差异审阅后方可应用
- AI 对话按文章关联,可从助手面板的「历史对话」恢复;新对话会保留旧入口。文章元信息与会话入口自动保存在应用数据目录的
history.db(SQLite)中,应用内重命名、移动和草稿正式保存会保留关联。 - 历史消息由 Agent 通过 ACP 加载,MarkGo 不另存消息正文。恢复需要对应 Agent 支持
session/load,且原会话仍可用;不支持或会话失效时会明确提示。删除对话入口不会删除 Agent 自身的历史。
- 一键复制带排版的富文本,粘贴到任意富文本编辑器
- 直接发布到微信公众号草稿箱,正文图片自动转存
- 导出 PDF:按编辑区样式直接生成,可设置纸张、方向、页边距,可选按一级标题分页(深色主题下不可用)
- 导出带排版的 HTML;安装 Pandoc 后还可导出 Word、OpenOffice、EPUB、PowerPoint、LaTeX 等格式(可配置参考文档、目录与额外参数,未安装时显示各平台安装方法)
从 Releases 页面下载对应平台的安装包:
| 系统 | 安装包 | 运行环境 |
|---|---|---|
| macOS(Apple 芯片与 Intel 通用) | MarkGo-<版本>-mac-universal.dmg |
macOS 11+ |
| Windows | MarkGo-<版本>-win-x64-setup.exe |
WebView2 运行时(Windows 10/11 通常已自带,安装程序会自动补装) |
| Linux | MarkGo-<版本>-linux-amd64.deb |
GTK 4 与 WebKitGTK 6.0(Ubuntu 24.04+ / Debian 13+) |
安装后,有新版本时可在「帮助 → 关于」(或侧边栏左下角的更新按钮)中点击「立即更新」,MarkGo 会自动下载、安装并重新打开,无需手动下载。
更新检查读取官网的静态 latest.json,不消耗 GitHub API 的匿名访问额度。自动检查每 6 小时进行一次,缓存保存在应用数据目录并由所有窗口共享;手动检查可刷新,1 分钟内的重复请求会合并。安装包仍从 GitHub Releases 下载。每次成功发布后,官网部署任务会同步生成更新清单;读取发布信息或安装包校验失败时停止部署,保留线上已有版本。
Windows 安装版支持右键点击 .md 或 .markdown 文件,选择「用 MarkGo 打开」(Windows 11 中位于「显示更多选项」)。菜单随安装或升级自动添加,卸载时移除。
Note
当前安装包未经代码签名。
- macOS:首次打开若提示「已损坏」或「无法验证开发者」,请在终端执行
xattr -cr /Applications/MarkGo.app后重新打开。 - Windows:若出现 SmartScreen 提示,请点击「更多信息 → 仍要运行」。
- 启动后通过「文件 → 打开文件夹」(
⌘⇧O)选择一个目录作为笔记库。笔记库以外的 Markdown 文件(「打开文件」⌘O、双击或拖到程序图标)会在主窗口中打开,侧栏同时切换到该文件所在的文件夹。 - 使用
⌘N新建笔记。在编辑区输入/可调出命令菜单,选中文字后可使用格式工具栏。通过/命令「元信息」可在文档开头添加标题、日期、标签等元信息,在「原生样式」下可展开编辑。 - 在底部状态栏选择排版主题、调整字号与段距,切换编辑区宽度与图片插入方式(图床 / 本地)。选择「原生样式」时,编辑区使用默认样式,发布时仍应用所选主题。
- 完成写作后,点击状态栏右侧的图标按钮,可复制排版内容或发布。
- 按 AI 写作 → 配置 安装并连接一个 Agent,在「设置 → 写作偏好」中设置写作风格、篇幅(短文 / 中篇 / 长文)与目标读者。
- 按
⌘J打开 AI 助手,点击「写文章」,输入话题并选择风格与篇幅,点击「生成大纲」。 - 在对话中与 Agent 讨论、修改大纲;满意后点击「开始写作」,MarkGo 会以建议标题新建文档,Agent 的输出实时流式写入编辑区(写作期间只读),完成后即可编辑。
- 用选区「AI」菜单润色或改写段落,再按上面的步骤排版发布。
AI 写作不直接调用模型 API,也不需要 API Key:能力由本机已安装的 Agent 提供,MarkGo 通过 Agent Client Protocol 以子进程方式与其通信(JSON-RPC over stdio)。
-
确保本机已安装 Node.js,并在终端完成所用 Agent 的登录:
Agent 登录方式 Claude Code 运行 claude后执行/loginCodex 运行 codex loginGemini CLI 运行 gemini完成授权OpenCode 运行 opencode auth loginQwen Code 运行 qwen完成授权GitHub Copilot 运行 copilot后执行/loginGoose 安装 Goose CLI 后运行 goose configure -
在「设置 → ACP 集成」中找到对应的 Agent,点击「安装」。预置 Agent 通过
npx启动,首次安装需要下载;连接成功后卡片上会标注「已连接」,已安装的其他 Agent 可点击「使用」切换。 -
其他支持 ACP 的 Agent 可通过「+ 添加自定义 Agent」添加,填写其 ACP 模式的启动命令后安装即可;展开卡片可修改启动命令或卸载。启动命令通过登录 shell 执行,会继承 shell 中的环境变量(如 API Key)。
- 写文章:在「设置 → 写作偏好」中设置写作风格、篇幅、目标读者和补充要求。在 AI 助手中点击「写文章」并输入话题,Agent 会先给出大纲;在对话中讨论修改,确认后点击「开始写作」,MarkGo 会以建议标题新建文档,Agent 的输出实时流式写入编辑区,写作期间编辑区只读,可随时停止,完成后即可编辑。初稿开头带有元信息(title、slug、summary、category、status、theme、tags、updated_at),写完后文档按元信息中的 title 命名。
- AI 公式:通过
/命令菜单选择「AI 公式」,或选中一段描述文字后点击格式工具栏中的「∑」,用自然语言描述即可生成 LaTeX 公式,预览确认后插入。 - AI 图表:通过
/命令菜单选择「AI 图表」、顶部工具栏或选中文字后的图表按钮,用自然语言生成 Mermaid 图表。支持停止生成、编辑源码和实时预览;语法通过后可插入文档并撤销,使用当前选定的 AI Agent。 - AI 助手(
⌘J):在侧边面板中与 Agent 对话,可引用当前选区。Agent 的执行计划、工具调用与权限请求均会显示在对话中。 - 内联 AI:选中文字后,在格式工具栏中选择「AI」,可执行润色、改写、扩写、精简、中英互译或自定义指令;也可通过
/命令菜单使用「AI 续写」「AI 指令」。结果会先在卡片中预览,确认后再替换或插入。 - 发布辅助:在发布对话框中,可由 AI 生成标题与摘要。
AI 生图直接调用图像模型接口,需在「设置 → 图片处理 → AI 生图」中选择供应商(OpenAI、豆包、通义万相、智谱、硅基流动或自定义 OpenAI 兼容接口),填写 API Key 与模型,并可调整超时时间。API Key 加密保存在本机。
通过 / 命令菜单选择「AI 生图」或点击顶部操作栏按钮,可输入描述、选择画面比例,并上传、拖入或粘贴参考图。GPT Image 与豆包 Seedream 4 / 5 支持参考图和文字改图;其他模型按已适配能力显示比例,未知模型保留默认文生图。最多添加 4 张 PNG / JPEG / WebP 图片,每张不超过 10 MB。
正文图片操作条的「AI 改图」会自动带入原图;生成后可继续修改、切换本次最近 6 个结果、另存图片,或插入文档 / 替换原图。替换可通过撤销恢复。自动比例使用最接近原图的可用尺寸,不拉伸图片。生成结果仅在当前窗口暂存,关闭后清空;插入时再按图床设置上传到 PicGo 或保存到本地图片目录。
为保证文档安全,Agent 对文档的任何修改都不会直接生效:
- Agent 通过 ACP
fs/read_text_file读取的是编辑器中的实时内容,包含尚未保存的修改。 - Agent 通过
fs/write_text_file写入的内容会先在编辑区以「段落级 + 词级」差异展示。用户可逐处接受或拒绝,确认后一次性应用,并可通过⌘Z撤销。 - 若 Agent 绕过 ACP 直接修改了磁盘上的当前文件,MarkGo 同样会检测到并进入审阅流程。此时选择拒绝,文件将恢复为修改前的内容。
MarkGo 通过 PicGo 或 PicList 的 HTTP Server 上传图片:
- 安装并启动 PicGo 或 PicList,并配置好图床,例如七牛云、腾讯云 COS、阿里云 OSS、GitHub、SM.MS 等。
- 在 PicGo「设置 → 设置 Server」中开启 Server,默认监听地址为
127.0.0.1:36677。 - 在 MarkGo「设置 → 图片处理 → 图床」中选择「PicGo 图床」,然后点击「测试上传」进行验证。
上传使用接口 POST /upload,请求体为 {"list": ["<本地路径>"]}。剪贴板中的图片会先写入临时文件,再提交上传。
目前支持发布到微信公众号草稿箱。
- 在「设置 → 发布渠道」中填写公众号的 AppID 与 AppSecret。AppSecret 经系统钥匙串加密后仅保存在本机。
- 在公众号后台「设置与开发 → 基本配置 → IP 白名单」中添加本机的公网出口 IP,否则接口会返回错误码
40164。 - 公众号需具备草稿箱接口权限,即已认证的服务号或订阅号。
发布在主进程中完成,不受浏览器跨域限制:
stable_token
→ media/uploadimg 上传正文图片(非 JPG/PNG 或超过 1 MB 的图片自动转码压缩)
→ material/add_material 上传封面(永久素材)
→ draft/add 写入草稿(标题、作者、摘要、原文链接、留言设置)
发布对话框会自动提取以下信息,所有字段均可修改:
- 标题:优先使用 front matter 中的
title,其次使用文中第一个标题。 - 摘要:取正文前 120 字。
- 封面:取正文首图。
默认会去除正文中与标题重复的一级标题。
- 行内公式:输入
$E=mc^2$即自动转换。为避免误识别金额,$内侧不能是空格,结尾$后不能紧跟数字。 - 公式块:在空行输入
$$后回车,或使用公式块快捷键与/命令菜单。 - 点击公式即可编辑 LaTeX 源码,实时预览,也可以用自然语言让 AI 生成。
- 复制排版内容或发布时,公式会转换为 SVG,目标平台无需支持 LaTeX。
- Go 1.26+
- Node.js 22+ 与 npm
- Wails 3 CLI:
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0,可用wails3 doctor检查环境 - Linux 另需
libgtk-4-dev、libwebkitgtk-6.0-dev;Windows 打包需 NSIS
wails3 dev # 开发模式(前端热更新,Go 代码修改后自动重启)
wails3 build # 构建当前平台的可执行文件到 bin/
wails3 package # 打包当前平台(macOS .app / Windows NSIS 安装包 / Linux deb 等)
go test ./internal/... # Go 单元测试(含基于 ACP 协议的模拟 Agent)
cd frontend && npm test # 前端单元测试(Vitest)
cd frontend && npm run typecheck # 前端类型检查
cd frontend && npm run screenshots # 重新生成介绍页截图到 site/assets(需本机安装 Chrome)Wails 3 · Go · React · TypeScript · Vite · Tiptap 3(@tiptap/markdown)· jsdiff · marked · lowlight · lucide-react · Vitest
前端界面只依赖 window.markgo 接口(frontend/src/shared/types.ts 中的 MarkGoApi)。frontend/src/bridge.ts 用 Wails 运行时实现它:方法经 Call.ByName('main.Bridge.<方法>') 调用 Go 端 Bridge 服务,Agent 会话、菜单、打开文件等由 Go 端通过 Wails 事件推送。
目录结构
main.go # 应用入口:窗口、单实例、文件关联、/mg-asset/ 本地图片中间件
bridge.go # 绑定到前端的 Bridge 服务(对应 window.markgo 的每个方法)
menu.go # macOS 菜单栏、Windows / Linux 托盘菜单
exporter.go # 导出:PDF 由编辑区直接打印生成,其他格式经 Pandoc
themes.go # Typora 主题的导入、列出与删除(经 /mg-theme/ 提供给前端)
updater.go # 应用内自动更新:下载对应安装包,安装后重启
internal/
├── settings/ # 设置持久化与迁移(密钥经系统钥匙串中的密钥 AES-GCM 加密)
├── files/ # 笔记库文件树与文件操作、本地图片路径解析
├── images/ # PicGo 上传与本地 assets 存储
├── imagegen/ # AI 生图(OpenAI 兼容接口 / 通义万相异步任务)
├── wechat/ # 公众号接口:access token、图片转存(必要时缩放转 JPEG)、草稿
├── acp/ # ACP 客户端:JSON-RPC、Agent 进程、会话、权限、文件读写代理、外部修改检测
├── export/ # 调用 Pandoc 导出 Word、EPUB 等格式,Pandoc 安装引导
├── pdfprint/ # 调用各平台 WebView 打印接口静默生成 PDF
├── themes/ # 导入的 Typora 主题(CSS 及其字体、图片等资源)
├── update/ # 通过 GitHub Releases 检查新版本并下载安装包
└── platform/ # 移到废纸篓 / 回收站、用户数据目录
frontend/
├── src/
│ ├── bridge.ts # window.markgo 的 Wails 实现;Windows / Linux 快捷键
│ ├── App.tsx
│ ├── components/ # 编辑器、侧边栏、状态栏排版控件、AI 面板、差异审阅、设置与发布对话框
│ ├── lib/ # 排版主题、渲染管线、编辑区样式、差异审阅、AI 对话状态
│ └── shared/types.ts # 前后端共享的类型定义
└── tests/ # Vitest 测试
build/ # Wails 构建配置(config.yml)、各平台图标与打包脚本
site/ # 介绍页(GitHub Pages),修改后推送到 main 自动部署
scripts/screenshots/ # 介绍页截图脚本:模拟 window.markgo 与示例笔记库,在 Chrome 中渲染真实界面
Windows 与 Linux 使用无边框窗口,标题栏与窗口按钮由前端绘制,菜单快捷键由 bridge.ts 处理;macOS 使用系统菜单栏与红绿灯按钮。
GitHub Actions 会在每次推送时执行类型检查与测试。推送 v* 标签(或手动触发工作流)后,会自动打包三个平台的安装包;推送标签时还会创建 GitHub Release。
-
在
CHANGELOG.md中添加新版本的小节,例如## v0.1.1,按需写「修复问题」「新增功能」「优化改进」三级标题(没有内容的不写),最后是「下载地址」(链接中的版本号替换为新版本)。Release 说明取自该小节,缺少小节或「下载地址」时,发布任务会失败。 -
同步更新版本号:
main.go中的Version、build/config.yml的info.version(随后执行wails3 task common:update:build-assets)、frontend/package.json。 -
提交并推送标签:
git tag v0.1.1 git push --follow-tags
欢迎通过 Issues 反馈问题或提出建议,也欢迎提交 Pull Request:
-
Fork 仓库并从
main创建分支。 -
按 开发指南 准备环境,用
wails3 dev验证改动。 -
提交前运行测试与类型检查:
go test ./internal/... cd frontend && npm test && npm run typecheck
-
面向用户的改动请在
CHANGELOG.md的「未发布」小节中补充说明。
本项目基于 MIT License 发布。
排版主题及公众号兼容处理移植自 MarkNice。
感谢 LINUX DO 社区提供交流与开源推广平台。