Skip to content

README_CN.md

Latest commit

 

History

History
175 lines (97 loc) · 11.5 KB

README_CN.md

File metadata and controls

175 lines (97 loc) · 11.5 KB
Raw

的觉得


一款免费、优雅、谁都能上手的 Markdown 编辑器。没有工具栏，没有多余的东西，而且文件永远是最新的。

Language / 语言: English · 中文 · 官网

ColaMD 是一款开源、免费、优雅的 Markdown 编辑器，用于写作、记录和文档。它为「只想好好写字」的人而做：没有工具栏、没有状态栏、不需要任何配置；你的文字和文件列表就是全部，标签栏只在你开第二个文档时才出现。

它支持所见即所得、12 个内置主题、富文本复制、智能换行、查找替换、文档大纲、PDF / HTML / Word 导出，并支持 macOS、Windows 和 Linux。

无论是什么在写这个文件（Claude Code、Codex 这类 AI Agent，一个脚本，或另一个编辑器），ColaMD 都会立刻显示最新内容，不用重开文件，也不用手动刷新。

License: MIT GitHub release

下载 | 功能

截图

ColaMD 打开的待办列表演示文档 ColaMD 渲染的表格与行内代码

交互式待办列表，以及边写边渲染的标题、链接、表格与行内代码。

主题

12 个内置主题，6 浅 6 深，灵感来自 Bear、Notion、iA Writer、Kindle、Solarized、Nord、Gruvbox 和 Dracula。每一个主题都是一份独立的 CSS 文件，放在 themes/，附带自己写主题的说明。

ColaMD 主题

功能

  • 文件实时同步: 无论是 AI Agent、脚本还是另一个编辑器改了文件，内容都会立刻出现在编辑器中，不用重开、不用刷新。

  • 真正的所见即所得: 输入 Markdown，直接看到富文本，无需分屏预览。

  • 文件与大纲: 浏览所选目录中的 Markdown 文件，或切换为文档大纲，专注在标题之间导航。

  • 源码模式: 需要查看或直接修改原始 Markdown 时，一键切换源码编辑。

  • 待办列表: 直接点击复选框完成任务，也支持快捷键。

  • 高亮与 LaTeX: 使用 ==高亮文本==，并通过 KaTeX 渲染数学公式。

  • Mermaid 图表: Mermaid 代码块在独立隐藏 iframe 中渲染为图表；点击图表即可编辑源码。

  • 查找与替换: 使用 ⌘/Ctrl+F 快速查找内容，支持替换当前匹配项或全部替换。

  • 智能换行: 单个换行直接渲染为换行，符合人类和 AI 工具写 Markdown 的习惯。

  • 富文本复制: 复制后粘贴到公众号、微信、邮件等富文本编辑器，格式完整保留。

  • 主题: 12 个内置主题，在浅色和深色环境中专注写作。

  • 最近文件与会话还原: 「文件 → 最近打开」直达最近 10 篇文档，启动时自动恢复上次编辑位置。

  • 编辑器字体设置: 为编辑器选择任意已安装的系统字体与字号，用户设置优先于主题默认。

  • 多窗口: 独立的编辑器窗口，各自维护保存状态与关闭保护。

  • 保存状态提示: 标题栏安静地显示未保存/已保存状态，随后自动淡出。

  • 标题锚点跳转: 点击文档内锚点链接即可跳转到对应标题，中文标题同样支持。

  • 版本更新说明: 每次更新后的首次启动自动打开内置 changelog，了解变化后不会重复打扰。

  • PDF、HTML 与 Word 导出: 将 Markdown 文档导出为带主题背景的 PDF、独立 HTML 或可编辑的 Word 文档。

  • 图片导出: 按电脑或手机的阅读宽度，把整篇导出为一张连续 PNG 长图；超长文档自动续为编号页面。

  • 图片路径可移植保存: 本地图片显示使用安全的 file:// URL，保存时恢复为相对路径。

  • VS Code 集成: 在 VS Code 中将当前 Markdown 文件直接打开到 ColaMD。

  • 极简设计: 没有工具栏，没有永久侧边栏，专注于内容本身。

  • 跨平台: 支持 macOS、Windows 和 Linux。

与现有 Markdown 工作流配合

ColaMD 不要求你改变现有习惯，也适合与 Obsidian、Typora、VS Code 等 Markdown 软件配合使用。它们共享同一套 .md 文件，你可以用不同工具完成不同任务。

下载

查看 Releases 获取最新构建。

平台 格式
macOS .dmg
Windows .exe
Linux .AppImage / .deb

路线图

ColaMD 会继续把「免费、优雅、专注」这件事做好：

  • v1.1: 实时文件热更新、文件关联、拖拽打开、主题系统

  • v1.2: 新图标

  • v1.3: Agent 活动指示器、Cmd+点击链接、富文本复制、智能换行、PDF 导出、主题持久化

  • v1.6: 更稳的实时同步：原子保存（rename）检测、watcher 自愈、关闭拼写检查

  • v1.6.1: 可勾选的待办列表（点击 / ⌘+Enter）、==高亮== 语法、Markdown 语法速查

  • v1.6.2: 暂时移除 HTML 导出

  • v1.7: 同目录文件列表：就地切换文件，Agent 新建/删除文件实时更新；搜索（⌘F）+ LaTeX（⌘⇧E），来自社区 PR #14

  • v1.7.1: 待办点击修复、居中的 SVG 对勾、标题栏文件面板开关按钮

  • v1.7.2: 可玩演示页：Help → 新功能演示（⌘⇧D），用真实目录展示每个版本的新功能

  • v1.7.3: 演示页升级为累积式 changelog：resources/demo/changelog.md 记录每个版本，打开即见

  • v1.7.4: 根据社区反馈完善文件面板、源码模式、HTML 导出、Windows 图片路径，并提供 VS Code 集成 MVP

  • v1.8.0: Markdown 与 HTML 本地图片均可移植保存，并完成社区反馈中的编辑修复

  • v1.8.1: 优化首次启动体验和 macOS 图标；移除 Mermaid 渲染，代码块恢复为原生可编辑体验

  • v1.9.0: Word 导出、电脑与手机阅读页图片导出、文档大纲、主题化 PDF 与更轻的启动加载

  • v2.0.0: 1000 star 里程碑：Mermaid 图表回归（按底色自动配色）、最近文件与会话还原、编辑器字体设置、标题锚点跳转、多窗口与保存状态提示

  • v2.0.1: macOS Universal 版本，同时支持 Apple silicon 与 Intel，并修复自定义主题恢复、Mermaid 渲染恢复和 Windows 更新下载问题

  • v2.0.2: 文件面板可调宽（180–420px，记住选择），大纲新增阅读进度高亮与跳转落点闪烁反馈

  • v2.3.0：文件面板里的文件夹可以就地展开，一个树根向下看，嵌套的文档只差一次点击；同时把外壳收紧一圈，标签从面板的边界线开始，拖拽调宽亮起的是分割线本身，长文件名改由浮层说全名，标题栏按钮用深浅表达状态

  • v2.7.0：编辑器内核重写，只认一条规则：编辑器里存的是文件的字节，渲染只是叠在字节上面的一层。你没碰过的字符保存后不会再变（表格分隔行和 *、$、_ 以前会被改写），长文档导出整篇而不是一屏，图片、链接、脚注、行内 HTML、Mermaid 图表、代码高亮与复制按钮、列表续行也都在新内核上补齐

  • v2.6.0：导出的 Word 里带上 Mermaid 图（按浅色画，因为 Word 是白纸），正文宽度多了三档（视图 → 正文宽度：640 / 780 / 1080，源码模式和 HTML、PDF 导出都跟着走），丢弃未保存内容之前先往 ~/.colamd/recovered 留一份副本，标签关闭按钮可点的范围扩到 24×24（可见的还是 16×16）

  • v2.5.0：文档变成幻灯片（视图 → 放映幻灯片，⌘⇧P）：一条 --- 一页，全屏放映，从光标所在页开始，主题的字体、表格、公式和图表每一页都在；同一套分页还能导出成 16:9 的幻灯片 PDF。编辑时按出的空行存成 Markdown 本来的空行而不是 <br /> 标签，--- 与 *** 混用的文件保存时保留多数派写法

  • v2.4.4：带 YAML frontmatter 的笔记保存后不再被改写（以前打开后直接保存就会把属性区重排成非法 YAML 并覆盖原文件），CRLF 的文件保存后还是 CRLF，导出 PDF 时宽表格不再丢掉最后一列，查找替换框不再被右上角的窗口按钮压住，从 Finder 打开的文件会落进你正在看的窗口，文件列表可以在视图菜单里换到左侧

  • v2.4.3：Windows 窗口按钮的颜色真正跟着主题——交给系统的颜色原本是它解析不了的写法，整次设置被拒，按钮一直停在开窗那一刻的颜色上（近黑的顶行上顶着一块浅灰）

  • v2.4.2：Windows 顶行三处修正：系统窗口按钮改用行图标的灰（原来用正文墨色，比谁都黑）、菜单按钮挪到整行最左端、左边右边间距对称

  • v2.4.1：全屏不再给已经不存在的红绿灯留位置；Windows 的外壳从三条横杆变成一行，菜单成为行尾的第四个图标；焦点框跟主题走而不是系统强调色；窗口菜单说界面语言；新建标签就能直接打字

  • v2.4.0：顶行重做：左边只有文档，右边是面板和打开它的三个按钮。标签占满整行、宽度有了上下限，外壳所有细线统一成一个不透明的灰，加号不会再被标签挤走，切换面板改用 ⌘\

  • v2.2.0：顶部永远只有一行，标签栏常驻，一个文档也是一个标签；再打开文件落成标签页而不是新窗口；窗口记住大小与缩放；PDF 导出有了跟随主题底色的页边距；新增「格式」子菜单与脚注悬停预览；界面颜色全面跟随主题

  • v2.1.2：标签栏更安静，第一个标签贴住窗口左边缘，去掉选中标签上那根主题色细线；编辑器是画布，外壳不抢戏

  • v2.1.1：标签栏右端加回加号；标签上支持右键菜单（关闭 / 关闭其他 / 关闭右侧 / 复制路径 / 在文件管理器中显示）；悬停提示改为一秒后才出现、且只显示 ⌘W

  • v2.1.0：标签页，一个窗口里同时开多个文档，每个标签各自保有内容、未保存状态、撤销历史与滚动位置；⌘T、File 菜单或文件列表里 ⌘ 加点击都能开一个；只有一个文档时不出现标签栏

  • v2.0.7：macOS 按芯片分别发布，首次下载从 216MB 降到约 82MB；新增 Windows 免安装 zip 版；文件面板支持右键菜单；文件名保持居中

  • v2.0.6：标题栏修正，「打开所在文件夹」按钮恢复可用、提示标签不再被正文压住或半透明、右上角按钮与上边距对齐

  • v2.0.5：修复「打开所在文件夹」按钮，鼠标移到文档名上即可出现

  • v2.0.4：PDF 导出不再把浮层当作正文、撤销不再跨文档、复制到聊天工具不再多出空行、源码模式与文件面板同开不再溢出、文档标题旁新增「打开所在文件夹」入口，并移除靠猜测的 Agent 活动指示器

  • v2.0.3: 查找替换、界面语言切换、大文档源码模式降级、更新下载进度与失败重试，以及基于 blockmap 的增量更新

  • 未来: 更多主题、编辑器集成与 Markdown 工作流优化

开源协议

MIT，永久免费。

ColaMD 由 Cola.app 开发，作者 orange2ai。欢迎提交 Issue、想法和 Pull Request。