Marlin墨鳞

2.6.0 — 2026-11-11

阅读时可以批注了：选中一句话，划线或写一句评论，文档本身一个字都不变。粘贴的图片、批注和 AI 摘要都放进项目里的一个 .marlin 文件夹，能跟着 Git 提交给同事。

批注

  • 阅读态里选中文字，上方浮出「高亮」「批注」：高亮只划线；批注再写一句评论，Ctrl+Enter 保存。右键菜单里也有
  • 被批注的文字带浅黄底，有评论的再多一条细线；鼠标移上去显示评论，点一下可以编辑、复制原文、删除
  • 侧栏新的「批注」页按文档先后列出所有批注，页签上是条数；点一条，正文滚过去，那几个字闪一下。只打开一个文件时，侧栏顶上原来的「目录」换成「大纲」「批注」两页
  • 文档改了以后，批注按原文和前后的字重新找位置，别处加减内容、挪段落都还在原句上；原句删掉了，归到「找不到原文」，评论还在
  • 批注存在项目的 .marlin\notes\ 里，作者是 Git 里设的名字（没设就是 Windows 用户名）；同事 git pull 拉下来的批注会马上显示。在文件树里改名、移动、删除文档，批注跟着走
  • 一次只能批注一段里的文字；图表、公式、图片、文档属性里不能批注。编辑、放映、导出、打印都不带批注，也不会发给 AI

项目的 .marlin 文件夹

  • 一个项目一个 .marlin，放在最外层：从文档往上找已经有 .marlin 的那层，没有就用 Git 仓库的最外层，都没有就用文档所在的文件夹。第一次粘贴图片、加批注或生成摘要时才建，文件树里不显示
  • 粘贴、拖进来的图片改存到 .marlin\assets\，文档里写相对路径（比如 ../.marlin/assets/image-xxxx.png），GitHub 和别的编辑器也能显示。拖进来的图片本来就在项目里时，直接引用原处。以前的 assets 文件夹和指向它的链接不动，照样显示
  • 设置里「图片存到」的默认值改成空（存到 .marlin\assets）；原来是默认的 assets 的，升级时改成空，自己填过别的文件夹的不变
  • AI 摘要改存到 .marlin\summaries\。以前存在 Marlin 数据文件夹里的摘要不再读取，想看摘要的文档要重新生成一次
  • 不想把批注和摘要分享出去，在 .gitignore 里写 .marlin/notes/ 和 .marlin/summaries/；不要忽略整个 .marlin/，否则图片也提交不上去。使用指南「文件夹」一章有说明

摘要卡片

  • 点标题「✦ 摘要」收成一行，摘要过时、正在生成时这一行上会写出来；收起还是展开，所有文档一起记住
  • 卡片底部的「展开阅读」在居中的大窗里按正文的字号读摘要，窗里也能复制、重新生成
  • 摘要里的 代码 和 加粗 显示成代码和粗体，不再露出反引号和星号

修正

  • 在文件树里改名后，摘要卡片偶尔显示成还没有摘要

2.5.0 — 2026-11-07

界面有了英文版：设置 → 外观 →「界面语言」选 English，马上换过来，打开的文档和没保存的修改都不受影响。

界面语言

  • 设置 → 外观最上面多了「界面语言」：简体中文、English、跟随系统（Windows 的显示语言是中文就用中文，否则用英文）。默认跟随系统：Windows 是英文的电脑升级后会变成英文界面，想要中文在这里选「简体中文」
  • 切换马上生效，所有打开的窗口一起换；正在编辑的文档、撤销记录、光标、查找框都还在
  • 英文界面覆盖标题栏、菜单、侧栏、设置、编辑器里的卡片和工具条、/ 菜单、表格、三种画板、Mermaid 的补全和报错说明、放映、AI 的各个面板，以及保存、Git、导出这些操作的提示
  • 英文界面下，/ 菜单和 AI 命令仍能用中文名、拼音找到（比如输入「代码」找到 Code block）
  • 插入的模板（表格、流程图、时序图、思维导图的示例文字）、新建文件的名字、默认的提交说明跟着界面语言
  • 提示框（> [!NOTE]）没写标题时，英文界面在预览和导出里显示 Note、Tip、Warning
  • 使用指南暂时只有中文；英文界面里「使用指南」照样打开中文版

AI

  • 英文界面里，内置命令显示英文名（Polish、Translate…），发给模型的是英文提示词；润色、续写这类命令仍按原文的语言回答，润色中文段落得到的还是中文
  • 翻译不填目标语言时，译成英文；原文已经是英文就译成中文
  • 「复制来改」按显示的名字存命令文件；和内置命令同名（中文名或英文名）的自己的命令会替换掉内置的
  • 外部 AI 助手（MCP）读到的工具说明和返回结果统一改为英文，对各家模型更稳；问你的确认框（打开文件夹、另存）跟着界面语言

其他

  • 安装程序选英文时，文件夹右键菜单是「Open with Marlin」，.md 的文件类型名是「Markdown document」
  • 导出的 HTML 按文档内容标注语言（中文为主标为中文，否则英文），读屏软件和浏览器的翻译更准
  • 起始页的搜索框加宽了一点

2.4.1 — 2026-11-04

修正几处和窗口、标签有关的问题：打开文档时反复出现「document N is not pending」、一次打开几个文件时卡住。

修正

  • 按 Ctrl+Shift+R 会刷新 Marlin 的界面，之后每个标签都显示「document N is not pending」。现在这些刷新键不再起作用；万一界面还是重载了（比如界面进程崩溃后），标签照常显示，没保存的修改和「*」标记都在
  • 在资源管理器里一次选中几个文件回车，Marlin 卡住、窗口一直空白
  • 开着几个窗口时，从外面打开的文件会同时出现在每个窗口的标签里；打开文件夹、AI 助手的确认框等也会跑到别的窗口

2.4.0 — 2026-10-30

选中文字后，上方出现格式工具条：加粗、加链接点一下就好，不用记快捷键，也不用看 Markdown 符号。

格式工具条

  • 实时预览和分栏里，选中文字停一下，选区上方出现工具条：加粗、斜体、删除线、行内代码、链接；配了 AI 模型时还有「✦ AI」（原来选区旁单独的「✦ AI」按钮并进了这里）
  • 选中的字已经是某种格式时，按钮是按下的样子，再点就去掉；点完选区还在，可以接着点别的，每点一次 Ctrl+Z 撤回一步
  • 点「链接」，工具条变成网址输入框，回车写成链接；已经是链接时可以改网址，清空后回车就去掉链接、文字留下；选中的字本身是网址时直接变成链接。有选区时 Ctrl+K 也打开这个输入框
  • 代码块、表格里和仅源码布局里不出现；设置 → 编辑器 →「选中文字时显示格式工具条」可以关掉（原来在设置 → AI，关过的仍是关的）

加粗等格式更顺手

  • 只选中粗体里的几个字，再点加粗（或 Ctrl+B）也能去掉整段粗体
  • 选区两头的空格不会被包进标记里；选了几段时每段分别加，不会写出跨段的标记
  • 选区只有一部分是粗体时，整段变成一个粗体
  • 行内代码里不再套别的格式

实时预览

  • 选中文字时不再露出 **、# 这些符号，选中的字不会挪动；只有光标单独停在格式里时才露出
  • 在粗体里按下鼠标开始拖选时，字不会在鼠标下面挪动

2.3.0 — 2026-10-30

有了完整的使用指南，在应用里随时打开。这台电脑上装了 Claude Code 的，可以直接拿它当 AI 模型。原来只有快捷键的功能，都补上了按钮和菜单。

使用指南

  • 官网新增使用指南：26 章加附录，每个功能在哪里、怎么用、用完是什么样，配了截图
  • ☰ →「帮助」→「使用指南」打开它；设置每一页底部的「这一页的说明」打开对应的章节
  • 起始页底部有「第一次用？看看 5 分钟上手」，打开过 10 个文件后不再显示

用本机的 Claude Code 当模型

  • 设置 → AI → 添加模型，选「Claude Code（用你的订阅）」：不用密钥和接口地址，用这台电脑上已登录的 Claude Code 回答
  • 它在一个空的临时文件夹里运行，不带工具、不读你的文件；取消时随即结束
  • 没登录、用量到了上限、打开了「只用本地模型」时，会说明为什么用不了

按钮和菜单

  • ☰ 菜单列出全部命令和它们的快捷键：保存、另存为、关闭标签，以及编辑、视图、显示、导出几个子菜单
  • 标题栏加了撤销、重做、查找、保存按钮；侧栏加了收起按钮；放映的工具条加了「退出」
  • 编辑器右键加了「撤销」「重做」；选中文字时还有「格式」：加粗、斜体、删除线、行内代码、链接
  • 编辑器里 Ctrl+B 是加粗（其他地方仍是开关侧栏）；Ctrl+Shift+Z 也能重做
  • 新增「另存为」：标签换成新文件，文档里的相对链接按新的位置改好
  • 设置 → 快捷键：所有快捷键按场景列出，可以按功能或按键搜索
  • 去掉了容易误按的 Ctrl+M（按了之后 Tab 不再缩进）和样式不一致的 Ctrl+Alt+G

表格

  • 正在编辑的表格里，鼠标停在行号的上下边缘、列头的左右边缘，出现「+」，点它就在那里插入一行或一列
  • 格子里换行（Shift+Enter）后，编辑时直接显示成两行，不再看到 <br>；多行的格子里 ↑ ↓ 先在格子里上下移动

修正

  • 写成 ../img/x.png（上一级目录）的图片显示不出来
  • 拉取冲突时，编辑器里冲突块的说明多了一个「的」（「下面是我的的」）
  • AI 结果在正文里逐处预览时，「✦ AI」按钮挡住预览的字
  • 状态栏「✦ Claude Code」弹出的小窗里，最后一句说明被截掉
  • 克隆对话框的「选择…」按钮折成两行
  • AI 助手（MCP）写过的文档，阅读时不能保存

2.2.0 — 2026-10-26

每次保存都会留一份历史，随时对比、还原。Claude Code、Codex 这类 AI 助手可以通过 MCP 直接读写 Marlin 里打开的文档（预览）。

文档历史

  • 每次保存自动留一份；第一次保存时，连保存前的原文也留一份
  • 标签右键或 ☰ 菜单里的「文档历史…」：按时间列出，选一份和现在的内容并排对比
  • 「还原到这一版」把那一版放回编辑器，还没保存，Ctrl+Z 一步撤回；还原前先把现在的内容存一份
  • AI 改过的版本标「✦ AI 改过」；改名、移动文件后历史跟着走
  • 历史存在 Marlin 自己的数据目录里，不放在文档旁边；每个文档留最近 50 份、30 天

AI 助手连接 Marlin（MCP，预览）

  • 设置 → AI → MCP：打开「允许外部 AI 助手连接 Marlin」，或者直接点 Claude Code、Codex、Cursor、Claude 桌面版旁边的「接入」，重启那个助手即可；改它的配置前先备份，只动 marlin 这一项
  • 助手能列出打开的文档、读全文和选区（包括还没保存的内容），能按片段改、改全文、改选区
  • 写进编辑器而不是直接写盘：文档变成未保存，每次写入 Ctrl+Z 一步撤回，写入前自动在文档历史里存一份「写入之前」
  • 你正在用输入法打字、或这个文档正在预览 Marlin 自己的 AI 结果时，助手的写入会被拒绝，让它稍后再试；你在它读完之后改过文档，它也要重新读
  • 助手写了不在前台的文档时，那个标签上出现紫点
  • 打开文件只能在已打开的工作区和文档所在目录里；打开文件夹、另存到别处会先问你
  • 状态栏显示「✦ Claude Code」：点开能看到最近的写入、「恢复到写入之前」，也可以「断开」
  • 默认关闭；只在本机连接，不开网络端口。内容会发给那个助手所用的模型，由助手决定

2.1.0 — 2026-10-25

Marlin 有 AI 了：选中一段让它润色、翻译、续写，用一句话画图、改图，给整篇文档写摘要。结果先在正文里逐处标出来，你接受了才改文档。

AI 默认不开：在 设置 → AI 里添加模型后才出现。支持 DeepSeek、通义千问、智谱、Kimi、豆包、OpenAI 等 OpenAI 兼容接口，也支持本机的 Ollama、LM Studio。

用法

  • Ctrl+J 打开命令面板：搜命令，或者直接输入你想让它做的事；Tab 切换范围（选中的文字、当前段、全文），面板会标出这次要发送的内容
  • 选中文字停一下，旁边出现「✦ AI」，点它也能打开面板（设置 → AI 里可以关掉）；右键菜单里有「AI 润色」「AI 修正错别字和语法」
  • 改写：润色、精简、扩写、改写、换语气、翻译、修正错别字和语法
  • 生成：续写、按描述写一段、写大纲、生成表格、标题备选
  • 最近的提问会记住，下次直接选

先预览，再生效

  • 生成时新文字淡淡地出现在原文后面，随时可以停止
  • 生成完逐处显示：删掉的划线，新加的淡色；范围下方的浮动条上可以一处处接受或拒绝，也可以全部接受、全部拒绝、重新生成；鼠标停在某一处上也能直接接受或拒绝
  • 「只看结果」看改完的样子，「对照」切回来
  • 键盘：Enter 接受、Backspace 拒绝、Tab 下一处、Ctrl+Enter 全部接受、Esc 全部拒绝
  • 接受后 Ctrl+Z 一步撤回；预览期间文档其他地方照常编辑

图

  • 「用一句话画图」：流程图、时序图、思维导图、甘特图等都行
  • 「用一句话改图」，图的语法出错时点红色提示条上的「让 AI 修」
  • 画板（流程图、时序图、思维导图）里点「✦ AI 改图」说一句话，图上标出改了哪里，不满意点「撤销这次」
  • AI 给的图先检查能不能画出来，画不出来会自己再试，仍不行就不改文档

摘要

  • 侧栏「大纲」上方的摘要卡片：一键给整篇文档写摘要，长文档也行
  • 摘要只存在本机，不写进文档；文档改过后提示摘要可能过时

自定义命令

  • 一个 Markdown 文件就是一条命令：写好提示词、作用范围、替换还是插入；内置命令可以「复制来改」
  • 设置 → AI →「打开命令文件夹」

隐私

  • 只在你发起 AI 操作时才发送内容，只发面板上标出的那部分，发给你选的模型；不在后台发送任何东西
  • 第一次发给云端模型前会说明发到哪里，确认后才发
  • 密钥存在 Windows 凭据管理器，不写进设置文件
  • 设置 → AI →「只用本地模型」打开后，只能用本机的模型

2.0.3 — 2026-10-23

状态栏能看字数了；多光标真正可用，Tab 能跳出自动补上的括号；宽表格的第一列横向滚动时固定不动。

写作

  • 状态栏显示字数，只数读者看得到的文字（不算代码块、图、公式和链接地址），停下打字后更新；选中文字时显示「选中 n / 全文」，点一下看中文字、英文单词、不含标点的字数
  • 光标在自动补上的右括号、右引号前按 Tab，跳到它后面；其他地方照旧缩进
  • 多光标：Ctrl+D 加选下一处相同的内容，Ctrl+Shift+L 选中全部相同的内容，Alt+点击 加一个光标，Esc 先回到一个光标；按列选择改为 Shift+Alt+拖动

表格

  • 每列至少 5 个字宽，中文列不再被长代码挤成一字一行；放不下时表格在原地左右滚动
  • 宽表格左右滚动时第一列固定，里面的长文字自动折行

更新

  • 检查更新时 GitHub 连不上会再试国内镜像地址（镜像上线后生效）

2.0.2 — 2026-10-15

Marlin 会自己检查更新了：有新版本时状态栏提示，点一下就下载安装，装好后自动打开原来的窗口。安装包和历史版本搬到了公开的 marlin-releases。

这一版本身还需要手动安装一次，之后的版本就能自动更新。

自动更新

  • 启动几秒后在后台检查，一天最多一次；只向 GitHub 查询有没有新版本，不发送任何文档内容
  • 有新版本时状态栏右边出现「新版本 x.y.z」，点开能看到这一版的更新说明，可以「下载并安装」「跳过这个版本」或「以后再说」，不强制
  • 安装包下载后先验签名，对不上就不装；有没保存的文档时先全部保存再装
  • 设置 → 关于：「自动检查更新」开关（默认开）和「检查更新」按钮
  • 便携版只提示有新版本，按钮打开下载页，不自动替换文件

修正

  • 实时预览里点表格的格子进入编辑，页面会跳到表格下面的内容
  • 分组之间有连线的流程图（如 libs --> SINK，libs 是分组）在画板里只能看、不能改
  • 放映时右键菜单里有「编辑」「在画板里编辑」「编辑源码」；放映时按 Esc 关右键菜单会连放映一起退出

2.0.1 — 2026-10-11

右键菜单理顺了：各处都是同一种菜单，右键一个东西就是它的「⋯」；浏览器自带的「返回、刷新、另存为、打印」菜单不再出现。同步面板和文件树可以「放弃改动」。

右键菜单

  • 各处的菜单样子一样：分组之间有分隔线，右边写快捷键，用不了的项置灰，删除这类操作是红色；↑ ↓ Enter 可以用键盘选，Esc 关
  • 实时预览里右键图、图片、表格、公式、HTML 块或卡片头，和点它的「⋯」是同一份菜单；图还有「复制图片」「保存为 PNG…」，图片还有「替换…」
  • 编辑器正文：剪切、复制、粘贴、粘贴为纯文本、全选（拼错的词先列拼写建议）；「粘贴」和 Ctrl+V 一样，截图会存成图片
  • 阅读视图：复制、全选、「编辑」（进入编辑，光标在右键的那一段）；链接多了「打开链接」「复制链接地址」，图片多了「复制图片」「在资源管理器中显示」，图多了「在画板里编辑」
  • 标签页：关闭、关闭其他、关闭右侧、固定、复制路径、在资源管理器中显示、在文件树中显示
  • 同步面板的文件：打开、和上次提交比较、复制路径、在文件树中显示
  • 表格网格的格子：剪切、复制、粘贴，以及这一行、这一列的操作
  • 文件树的文件右键最上面加了「打开」
  • 输入框、文本框保留系统的剪切、复制、粘贴菜单

放弃改动

  • 同步面板里文件的右键、「⋯」里的「放弃全部改动」，文件树里有改动的文件或文件夹的右键
  • 先问，列出要放弃的文件；改过、删掉的恢复成上次提交的样子，新文件移到回收站
  • 放弃前把现在的内容备份到仓库的 .git/marlin-backup；开着的文档有没保存的修改，也先存进备份

修正

  • 实时预览里编辑表格后，点表格下面的文字会把最后一行选中
  • 实时预览的代码块、图表卡片里选中文字看不到选中的底色
  • 流程图画板选中一条长连线时，选中框盖住半张图；现在亮的是线本身，改名框在标签上
  • 换主题（包括跟随系统切换明暗）后，实时预览里的图有的还是旧主题的颜色

2.0.0 — 2026-10-09

画板大版本：流程图、时序图、思维导图都能不写一行语法画出来、改好，文件里始终只有纯 Mermaid 文本，git diff 只有改到的那几行。写源码的人也有补全和中文报错。

流程图画板

  • 右边常驻属性面板：节点的文字、8 种形状、颜色、所在分组；连线的两端、标签、线型（实线 / 虚线 / 粗线 / 隐形）、末端（箭头 / 无 / 圆头 / 叉头）、反转方向；分组的标题、方向、解散；什么都没选时是整张图的方向
  • 键盘画图：选中节点按 Tab 接一个新节点、Enter 加同级，直接打字改文字（中文输入法也行），方向键换选中；从节点右侧的圆点拖到空白处新建并连上
  • 框选、Ctrl+A 全选，多选时形状、颜色、分组一次改全部；Ctrl+G 放进新分组，分组可以嵌套
  • 拖到另一个节点的左右是调同层顺序，上下是放到它上面 / 下面；每次修改后节点平滑滑到新位置
  • 画板新建的节点 id 取它的文字（登录 --> 校验），作者写的 id 从不改
  • 认得更多写法：A-->B（不留空格）、A@{ shape: … }、A:::class、连线 id、linkStyle（删改连线后序号自动改对）、两种梯形和双圆

时序图画板

  • 左边时间线、中间图、右边属性面板；点图里的消息、注释、框就选中对应的行
  • 行里直接改文字，Enter 写入并在下面加一条回复；拖 ⋮⋮ 或 Alt+↑↓ 调顺序，拖进框里就进了框；多选后「包进」循环、分支、可选、并行等框
  • 参与者左右拖动排序、双击改名、方框 / 小人；消息的两端、10 种箭头、激活、反转；注释的位置；框的条件、加一段、解开；自动编号
  • 做不了的操作会说明原因（比如结束一个还没开始的激活、删除还有消息用到的参与者）

思维导图画板

  • 像 XMind 一样在图上改：选中主题直接打字，Tab 加子主题、Enter 加同级、Shift+Tab 升级、Alt+↑↓ 调顺序、Delete 删除；拖到别的主题中间放进去，拖到上下边排到前后
  • 工具栏「大纲」打开左边的大纲，适合大段整理
  • 7 种形状和图标；改字、挪动都保留原来的缩进风格和注释
  • 新的树状布局：加一个主题时别的分支不动（Mermaid 默认的布局每改一次整张重排）。「/」新建的思维导图默认就是树状；旧图打开画板时一键换成树状。GitHub 等地方照常按原布局显示

三种画板都有

  • 「改动 N」：标出和打开时相比改了什么，新加的绿、改过的蓝，删掉的列在状态栏
  • 撤销重做、缩放平移、全屏；完成后整个画板的修改是编辑器里的一步撤销
  • 画板改不了的写法就只读，并说明原因，不会写坏文件

写源码

  • 补全：mermaid 代码块里打字时弹出图的类型、本图已有的节点和参与者、关键字、连线和箭头写法，都带中文说明；选了箭头接着弹出另一端
  • 中文报错：图渲染失败时说清楚是第几行、什么问题（「注释要用 %% 开头，不是 //」）；常见错误旁边有「修复」按钮，一步改好
  • 「/」新建流程图、时序图、思维导图：源码里插入后直接打开画板，实时预览里留在卡片里等你填字
  • 粘贴一份提纲（列表、缩进的文字或标题）后，旁边出现「转成思维导图」，一点就成图，Ctrl+Z 换回原文；在思维导图画板里选中主题粘贴，几行按层级加成子主题

其他

  • 标题栏的「放映」「导出」只在阅读时显示（编辑时 F5、Ctrl+P 照常可用）
  • 「/」菜单去掉了甘特图模板
  • 修正：实时预览里图片工具条的「⋯」菜单出在图片底下，现在紧贴按钮
  • 修正：启动后马上双击文件树里的文件，偶尔什么都不打开
  • 修正：「最近打开」偶尔显示为空，两个文件同时打开时甚至可能丢掉整个列表；设置等文件现在都是写完整再替换

1.5.0 — 2026-10-05

按 F5 把文档全屏放映出来讲：先是封面，之后正文连续滚动、不分页，不用另做幻灯片。讲的时候可以用激光笔指、用画笔圈，笔迹跟着内容走，退出就清空，不改文档。

放映

  • F5 或标题栏「▶ 放映」：窗口全屏，只剩文档；编辑时也能放映（放的是排好版的内容），退出后回到原来的编辑布局
  • 封面：标题取文档属性里的 title、第一个一级标题或文件名，下面一行作者 · 日期；文档开头的属性表放映时不显示
  • 正文自动放大到适合屏幕宽度；右下角工具条上可 − / + / 「适应」，Ctrl 0 回到适应屏幕
  • ↓ ↑（PageDown PageUp、空格）翻一屏；→ ← 在文档用到的最高两级标题之间跳；Home / End 到封面、文末；Esc 退出，窗口、缩放都恢复
  • 鼠标停 2 秒自动隐藏
  • 比一屏高的 Mermaid 图缩到一屏之内；点图全屏看全貌，可缩放、拖动，Esc 回到放映

演示笔

  • 激光笔 L：跟着鼠标的红点，带短拖尾，不留痕迹
  • 画笔 P：5 种颜色（1–5）、细 / 中 / 粗，线宽随数位笔压感变化
  • 荧光笔 H：半透明黄色；橡皮 X：碰到哪一笔擦掉整笔；C 全部清除
  • 笔迹跟着内容滚动和缩放，压在原来的字上；拿着笔时 Esc 先放下笔，再按一次才退出放映

1.4.0 — 2026-10-05

文件夹在 Git 仓库里时，Marlin 能看出改了什么，一键提交、拉取、推送，冲突在应用里逐个解决，也能直接克隆仓库。用的是电脑上装的 git，登录交给 git 自己（SSH 密钥或登录窗口），Marlin 不保存任何密码。不在仓库里、没装 git 时，一切和以前一样。

看得到改了什么

  • 文件树：改过的文件标 M（黄），新文件标 U / A（绿），冲突和删除标红；里面有改动的文件夹带一个点
  • 状态栏：分支，↑ 没推送的提交数，↓ 远端的新提交数；点它打开「同步」页签
  • 打开文件夹时在后台获取一次远端，之后默认每 10 分钟一次（设置 → 打开文件 → Git），只获取不合并；不弹登录窗口
  • 在终端里 commit、pull，或保存文件后，1 秒内更新
  • 编辑器（分栏、仅源码）：和上次提交比，改过的行左侧有色条（新增绿、修改蓝、删除处红三角）；点色条看原来的内容，「还原这一块」

同步

  • 侧栏「同步」页签：改动列表带勾选框，点文件名并排对比；提交说明不填就按改动生成（「更新 a.md、b.md」）
  • 「同步」一键完成：保存打开的文档 → 提交勾上的 → 拉取（rebase）→ 推送；「⋯」里也能单独提交、拉取、推送、获取
  • 只提交勾上的文件；还有没提交的改动时拉取，先问要不要暂存
  • 出错时用中文说明原因：连不上远端、远端拒绝登录、要先拉取、没设置名字和邮箱
  • 没设置提交用的名字和邮箱时在面板里填，只写进这个仓库

冲突

  • 拉取遇到冲突时停下，逐个文件选「保留我的」「使用远端」或「手动改」；用远端的内容前先把我的版本备份到 .git/marlin-backup
  • 编辑器里的冲突块写明上面是远端的、下面是我的，带「用远端的 / 用我的 / 两个都要」按钮
  • 全部解决后「继续」完成拉取并推送；随时可以「中止」，回到拉取之前

克隆

  • 起始页和菜单里的「克隆仓库…」：填地址、选位置（记住上次的位置），完成后打开

1.3.0 — 2026-10-05

编辑模式多了第三种布局「实时预览」：直接在排好版的正文里改，代码、公式、图表、表格、图片、折叠块都是原地可改的卡片，不露 Markdown。表格可以像表格软件一样编辑。

实时预览

  • 编辑时的第三种布局，和「分栏」「仅源码」并列：Alt+1 分栏、Alt+2 实时预览、Alt+3 仅源码（阅读时按也直接进编辑），标题栏三段按钮点一下就到；Ctrl+\ 照旧轮换。设置 → 编辑器里可以设为默认
  • 标题、粗体、斜体、链接、列表、引用、提示框按阅读样式显示，光标所在处才露出 **、# 这些符号；任务列表的复选框点一下就勾上
  • 代码块是卡片：头上选语言、复制，代码原地改，看不到围栏
  • 公式块是卡片：上面写 LaTeX，下面实时排版；行内公式 $…$ 点一下在小框里改，带预览
  • Mermaid 图是卡片：上面写源码，下面边打边画；写错时一行红字指出第几行，图保留上一版；有模板、画板（流程图）和「⤢ 展开」大窗口。/流程图 插入后留在卡片里
  • 图片点一下出工具条：改说明文字、替换、复制删除移动；拖右下角调大小（写成 <img … width>），「原始大小」变回去
  • 折叠块 <details> 是卡片：头上改标题，下面直接写正文
  • 脚注引用显示成上标编号，文末的定义显示成脚注区，光标碰到时露出源码
  • HTML 块显示渲染结果，⋯ → 编辑源码 才露出源码
  • 每张卡片的 ⋯：复制整块的 Markdown、删除、上移、下移
  • 复制得到 Markdown 原文；查找能找到被隐藏的内容；三种布局来回切换时停在同一行；整页缩放同样作用于实时预览
  • 什么都不改时文件一个字节都不变（BOM、CRLF 保留）

表格

  • 实时预览里点表格的某一格，表格原地变成可编辑的网格，改一格写一格；分栏和仅源码里点第一行末尾的「✎ 编辑表格」打开表格面板
  • Tab / Enter 在格子间移动；增删行列、设对齐；拖行号、列头调整顺序；按某一列升序 / 降序（数字按数值、中文按拼音）
  • 拖过几个格子选中一块：Ctrl+C 复制出去能直接贴进 Excel，Delete 清空，Ctrl+V 贴进来；格子里 Shift+Enter 换行
  • 原表对齐就重新对齐，紧凑就保持紧凑，没改的行一个字符不动；一次 Ctrl+Z 退回整次编辑
  • /表格 先在弹出的网格里选几列几行

文档属性

  • 开头的 YAML（--- 之间的 title、owner、tags: [a, b] 等）显示成一张属性表，列表是小标签；不再变成分隔线和标题，也不进大纲。阅读、分栏预览、导出都一样

其他

  • 分栏右侧的预览和阅读模式一样只用来看，表格面板、画板都从编辑器打开，在当前布局上原地打开
  • <img src="相对路径"> 写的本地图片在预览和导出里也能显示
  • 修复：脚注的引用顺序和书写顺序不同时，脚注块的行号颠倒，滚动同步跑偏

Word 导入导出推迟到之后的版本。

1.2.0 — 2026-09-30

能打开整个文件夹了：左侧文件树，在树里管理文件，改名时同步改链接，按文件名快速打开、全目录搜索；图片、PDF 在标签里看，文本、配置和代码文件在编辑器里改。阅读模式改为纯阅读，整页可以缩放。

打开文件夹

  • 入口：起始页或菜单里的「打开文件夹…」（Ctrl+Shift+O）、把文件夹拖进窗口、命令行 marlin.exe <目录>、「最近打开」里的文件夹；安装版在资源管理器里右键文件夹（或文件夹里的空白处）有「用 Marlin 打开」，Win11 上在「显示更多选项」里
  • 一个窗口对应一个文件夹：当前窗口还没有文件夹就在这里打开，已经有了就开新窗口，已经开着的文件夹直接切过去；双击属于某个已打开文件夹的 .md，在那个窗口开标签
  • 侧栏分「文件 / 大纲 / 搜索」三个页签，宽度可以拖动并记住；Ctrl+Shift+E 切到文件树
  • 文件树：文件夹在前、数字按大小排（2.md 在 10.md 前）；按 .gitignore 和隐藏文件夹过滤，「⋯」里可切换「只看 Markdown」「显示被忽略的文件」；打不开的类型颜色淡一些；外部增删文件 1 秒内反映到树上；↑↓←→ 和 Enter 可以操作
  • 单击文件在「临时标签」里打开（标题斜体），再单击别的文件就替换它；双击、开始编辑或双击标签标题转为普通标签。临时标签不记进「最近打开」
  • 「最近打开」同时记文件和文件夹，起始页用「文件 / 文件夹」切换
  • 启动时不自动恢复上次的文件夹，起始页一键回去

文件管理

  • 树里右键：新建文件（预填 未命名.md）、新建文件夹、重命名（F2，只改大小写也行）、删除（Delete，进回收站，先确认，可勾「不再询问」）、复制路径 / 相对路径、在资源管理器中显示；拖到文件夹上就是移动
  • 已打开的文件被改名或移动时，标签跟着走，未保存的改动保留；被删除时，没改动的标签关掉，有改动的保留并提示
  • 改名或移动后，列出工作区里指向它的链接（[文字](路径)、![图](路径)、引用式定义），问要不要一起改；只改路径那一小段，#锚点、尖括号、百分号编码、BOM、CRLF 都保留，代码块里的文字不动。打开着的文档在编辑器里改，可以 Ctrl+Z 撤销
  • 点 [说明](guide.md#安装) 打开 guide.md 并滚到「安装」这个标题；找不到标题时停在开头并提示

搜索

  • Ctrl+Shift+P 快速打开：按文件名模糊查找，字母按顺序出现即可（rdme → README.md）；Enter 打开，Ctrl+Enter 新窗口；没打开文件夹时在「最近打开」里找
  • Ctrl+Shift+F 在文件夹中搜索：边输入边搜，支持区分大小写、全词、正则；结果按文件分组，点一条跳到那一行（Markdown 滚到那一段并短暂高亮，代码文件在编辑器里选中）；打开着、没保存的文档搜编辑器里的内容；跳过被忽略的、超过 5 MB 的和二进制文件

图片、PDF 与非 Markdown 文件

  • 图片（png jpg gif webp svg bmp avif）在标签里看，适应窗口显示，滚轮缩放、拖拽平移；PDF 用 WebView2 自带的查看器预览
  • .mmd / .mermaid 整个文件渲染成一张图，可以编辑、进画板，保存后仍是纯 Mermaid
  • 文本、配置、代码和脚本（json yaml toml xml csv log ini、js ts py rs go java c cpp cs php rb sh ps1 bat 等，以及没有扩展名的文件）在带语法高亮的编辑器里打开，可以编辑保存；保存时 BOM、CRLF / LF、末尾有没有换行都不变；Tab 跟着文件原有的缩进走。脚本从不运行
  • 超过 5 MB 或内容是二进制的文件、Word 等其他类型交给系统程序打开；exe、lnk、vbs 等程序只在资源管理器中显示，不运行
  • 从树里把图片拖进正在编辑的文档，插入相对路径

阅读、编辑与缩放

  • 阅读模式改为纯阅读：阅读时的任何操作都不会改动文档；画板入口只在编辑模式的分栏里；阅读时双击正文不再进入编辑
  • 整页等比缩放：正文栏、字号、图片、Mermaid、公式一起缩放，窗口放不下时正文重新换行；状态栏常驻 − 100% +，点百分比可选「适应窗口宽度」和常用比例；新增 Ctrl + 滚轮；缩放前后保持阅读位置

窗口与菜单

  • 标题栏最右边的「☰」菜单：新建文件、新建窗口（Ctrl+Shift+N）、打开文件、打开文件夹、最近打开、帮助（Markdown 语法速查 / 键盘快捷键 / 关于）、设置；原来标题栏上的新建、打开、帮助、设置图标收进了菜单
  • 已经开着 Marlin 时，从开始菜单或任务栏再启动一次，开一个新的空窗口（以前什么也不发生）

修复

  • 设置的快捷键页补上 Ctrl+Shift+P、Ctrl+Shift+F、Ctrl+Shift+N

1.1.0 — 2026-09-24

编辑态输入 / 呼出插入菜单，不熟悉 Markdown 语法也能写出表格、代码块、公式和 Mermaid 图。

/ 插入菜单

  • 在行首，或空格、中文标点之后输入 / 弹出菜单；URL、路径、代码、HTML 和公式里的 / 不触发
  • 继续输入即过滤，中文、拼音全拼 / 首字母、英文都能找到：/表格、/bg、/table
  • 条目：标题 1–3、引用、提示框、分割线、无序 / 有序 / 任务列表、代码块、表格、数学公式、折叠块、图片…、链接、脚注、流程图 / 时序图 / 思维导图 / 甘特图、今天日期
  • 插入后光标停在第一个要填的位置，Tab 跳到下一个空位（表格逐格填写）；Ctrl+Z 一次复原，连同那个 /
  • 「图片…」打开文件选择器：图片按粘贴图片的规则存进 assets/，已经在文档旁边的图片直接用相对路径，不复制
  • 「流程图」插入后自动切到分栏并打开画板
  • 过滤结果相同时，最近用过的排在前面
  • 光标所在的空行显示淡色提示「输入 / 插入内容」；设置 → 编辑器里可以关掉菜单

编辑

  • Ctrl+I 斜体：包住选中文字，再按一次取消
  • Ctrl+K 链接：选中文字变成链接文字、光标跳到网址；选中的是网址则反过来；没选中时插入 [文字](网址) 模板

阅读

  • 支持 GitHub 提示框（> [!NOTE]、[!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]），默认标题显示为注意 / 提示 / 重要 / 警告 / 危险，源码里写了标题则用源码的；配色在深浅主题下都清楚，自定义主题可用 --md-alert-* 覆盖

修复

  • 多屏时文件对话框（打开、新建、选图片、导出 PNG / HTML / PDF）可能出现在另一块屏上；现在都出现在 Marlin 窗口上方，并且是模态的
  • 在 / 菜单里用回车选「图片…」时，文件对话框上看不到鼠标指针（点击仍然有效）

1.0.0 — 2026-09-24

正式版。PRD 的 P1 功能全部完成，Mermaid 流程图可以不写语法、在画板里直接改。

Mermaid 画板

  • 流程图上点「✎ 编辑」或右键「编辑图…」，在全窗口画板里改图，点「完成」一次写回源码
  • 从托盘拖入节点（矩形、圆角、菱形、圆形等），从节点圆点拖出连线，双击改文字，切换形状，删除节点或连线
  • 多选后 Ctrl+G 编组，节点可拖进 / 拖出分组，分组可改标题、解组
  • 缩放、平移、全屏（F11），Ctrl+Z / Ctrl+Y 撤销重做
  • 写回只改动相关的几行，注释、%%{init}%% 和原有排版不动；画板打开期间源码被别处改了会提示冲突
  • 流程图默认样式更紧凑、字号小一号，同样面积能放下更多内容

编辑

  • Ctrl+S 只保存、留在编辑态；1 秒内连按 3 次才回到阅读态
  • 新建文件（Ctrl+N）：先选位置和文件名，建好后直接进编辑态
  • 查找替换（Ctrl+H）：区分大小写 / 全词 / 正则，显示「第几个 / 共几个」，正则替换支持 $1，全部替换一次撤销
  • 粘贴截图、拖入图片：存到文档旁的 assets/（可在设置里改），自动插入相对路径；同一张图重复粘贴只存一份
  • 英文拼写检查：内置 en-US 词典，代码、链接、驼峰和全大写词不查；右键给建议或加入词典，可在设置里关闭
  • 修复：鼠标选中文本时没有背景色、偶尔错位

阅读

  • 数学公式：$…$、$$…$$ 和 ```math 用 KaTeX 排版；写错的公式显示红色原文，悬停看原因；没有公式的文档不加载
  • 重新打开文件时回到上次读到的位置（按源码行记录，换窗口大小或缩放也对得上）
  • 代码块右上角「复制」按钮
  • 点正文里的图片放大查看，滚轮缩放、拖拽平移

导出与打印

  • 导出 HTML：单个文件，图表、公式、本地图片都内嵌，在别的电脑上打开和预览一样
  • 导出 PDF：直接存成 A4 文件，不经过打印对话框；主题背景铺满整页，每页都有页边距留白
  • 打印（Ctrl+P）：系统打印对话框；大文档也会打印全文
  • 超过约 4 MB 的文档（约 3000 页 A4）不再导出 PDF / 打印，提示改为导出 HTML；10 MB 文档导出 HTML 约 12 秒
  • Mermaid 图右键「复制图片」，2× PNG 直接贴进聊天软件或文档

起始页与窗口

  • 没有打开文件时显示起始页：「打开文件…」「新建文件…」和最近打开的 20 个文件；已移动或删除的文件划线显示，可从列表移除
  • 标题栏新增新建、打开按钮和「导出」菜单（导出 PDF / 导出 HTML / 打印）；设置按钮换成齿轮图标
  • 起始页重做：居中排版，「打开文件」「新建文件」两张卡片；最近打开默认列 6 个、可展开全部，文件名左、路径右对齐，可按文件名或路径搜索，回车打开第一个
  • 关闭最后一个标签回到起始页，起始页上再按 Ctrl+W 才关窗口
  • 设置面板重排：每项一行、标签左对齐，说明文字小一号且不超过两行；快捷键单独一页，一行一个
  • 「Markdown 语法速查」：标题栏「?」按钮或「设置 → 关于」打开，每种写法配效果对照
  • 起始页上不显示目录按钮
  • 修复：标签很多时标题栏的「导出」按钮被挤成两行

便携版

  • Marlin_1.0.0_x64-portable.zip 解压即用：设置、最近文件、WebView2 缓存都放在程序旁的 data\，不写用户目录，也不提示设为默认

已知限制

  • 仅 Windows x64
  • 10 MB 级文档在编辑态每次按键约 0.5 秒，阅读不受影响
  • 打印保留主题背景：深色主题用纸打印前建议切到浅色主题
  • 便携版与安装版同时运行时共用一个进程，后打开的文件会交给先启动的那个
  • 拼写检查只支持英文
  • Ctrl+Shift+T（主题）在中文输入法下可能被截走，状态栏按钮是主入口

0.1.0 — 2026-09-23（内测）

第一个可发的版本。PRD 里的 P0 功能都在，性能指标除内存一项外全部达标（那一项是 WebView2 的固定开销，指标已改为按文档增量计算）。

打开与阅读

  • 注册 .md / .markdown 文件关联，双击即开；命令行 marlin.exe <path> 与拖拽打开
  • 单实例：再次打开文件转交给已有进程，默认在最近使用的窗口里新开标签
  • CommonMark + GFM：表格、任务列表、删除线、脚注、自动链接
  • 代码高亮，除 syntect 自带语法外另打包 TypeScript / TSX、Kotlin、Swift、Dart、TOML、Dockerfile、Nginx、GraphQL、Protobuf、SCSS、INI
  • 目录侧栏，滚动时高亮当前章节，点击跳转
  • 页内查找（Ctrl+F），用 CSS Custom Highlight API，不改动已渲染的 DOM
  • 非 UTF-8 文件（GBK、Big5、UTF-16 等）自动探测并只读打开，一键转成 UTF-8 后可编辑
  • 相对路径的图片与本地 md 链接按文件所在目录解析；外链交给系统浏览器

编辑

  • E 进入编辑，左源码右预览，双向滚动同步，Ctrl+S 保存并回到阅读态
  • 保存是「写临时文件 + 原子改名」，保留原文件的 BOM 与换行符
  • 保存前检测文件是否被外部改动，冲突时交给用户选择；未编辑时外部改动自动重载
  • 崩溃恢复：编辑中定期快照，异常退出后重开提示恢复
  • 连打时的多次改动合并成一次渲染，大文档不会越拖越远

Mermaid

  • 全图类型按需加载，纯文本文档不加载这部分代码
  • 样式从主题变量推导，换主题自动重渲染
  • 语法错误时保留上一次成功的图并标出行号，点击跳到源码
  • 点击放大（滚轮缩放、拖拽平移）；右键复制 SVG、导出 2× PNG
  • 改一张图只重渲染这一张（20 图文档实测 41 ms）

主题与设置

  • 内置 6 套预览主题：Marlin Light / Dark、GitHub Light / Dark、学术、护眼绿
  • 代码高亮主题可独立选择：跟随主题 / GitHub / One Dark / Solarized Light
  • 跟随系统明暗，明暗各自可指定主题
  • 字号、行高、正文宽度、正文字体可覆盖；Ctrl +/-/0 临时缩放
  • 自定义主题放进 <app data>/themes/<id>/，改动即时生效，无需重启
  • 设置存 <app data>/settings.json，多窗口实时同步

窗口与文件

  • 多标签多窗口，同一文件跨窗口聚焦已有标签
  • 记住窗口位置与大小，新窗口相对上一个偏移
  • 设置项：外部打开的文件进标签还是新窗口

大文档

  • 超过 1000 块的文档由 Rust 分页交付，前端只渲染视口附近的块
  • 10 MB 语料：启动到可见 1.8 s，补齐期间滚动 68–75 fps，补齐后 140 fps
  • 渲染核心的高亮与净化并行化：1 MB 语料 167 ms → 67 ms

安装器

  • NSIS，安装到当前用户目录，不需要管理员权限
  • 覆盖升级保留设置、主题与文件关联；运行中升级会提示关闭
  • 卸载可选删除应用数据，并清理文件关联（不留下指向已删除程序的 .md 关联）
  • .md 文件有独立的文件图标，与应用图标区分

已知限制

  • 仅 Windows x64
  • 10 MB 级文档在编辑态每次按键约 0.5 秒（comrak 每次整篇重新解析），阅读不受影响
  • 内存基线由 WebView2 决定：空窗口约 450 MB 工作集 / 230 MB 私有，文档本身 1 万字约多占 20 MB
  • Ctrl+Shift+T（主题）在中文输入法下可能被输入法切换热键截走，状态栏按钮是主入口
  • 卸载再安装后，需要重新点一次「设为默认打开方式」