MaxInk 使用文档

MaxInk 只做一件事,并把它做到极致:让 Markdown 写作回归纯文本、回归你自己的文件夹。它是一款 macOS 原生的轻量读写器——双击秒开、边写边渲染、纯文本随时带走、百万字也不卡;文件永远是标准 .md,不进 vault、不进专有数据库。本文从装机讲到写作、渲染、阅读、导出、文件恢复与自动刷新,逐章覆盖当前版本 v0.14.4 的真实用法。

下载 MaxInk 返回产品页

快速开始 · 装机

装机只有一步,但 MaxInk 的立场从第一天就写在这里:轻、不锁、不卡。你的文件就是标准 .md,存在你自己选的位置,随时用别的工具打开、随时带走。

  1. 下载通用版 dmg。到下载页拿到通用版(Universal)安装包;一个包同时支持 Apple Silicon 与 Intel Mac,无需区分架构,需 macOS 10.15+。
  2. 拖进「应用程序」。双击 dmg,把 MaxInk 拖入「应用程序」即可完成安装。
  3. 双击即开。安装包已 Apple 签名并公证,不需要额外命令绕过拦截,打开就能用。
轻、不锁、不卡的底气:文件绝不进 vault 或专有数据库;软件免费、签名公证、不联网采集。你随时可以换掉 MaxInk,而不必先把内容搬出来。

双击秒开 / 设为默认

「双击一个 .md 就直接开始编辑」是 MaxInk 的招牌体验——省掉「先开 App、再翻文件」的每一次摩擦。

MaxInk 已关联 .md / .markdown,在访达里双击就直接进 MaxInk 打开那个文件。若双击没用 MaxInk 打开,说明系统里 .md 的默认程序是别的(VS Code、TextEdit 等),按下面任一方式改回:

  1. 一键设为默认。到设置 → 默认打开方式点「设为默认」一次即可。
  2. 或从访达改。在任意 .md 上右键「显示简介 → 打开方式 → 全部更改」选 MaxInk。

行内实时预览

「所写即所见」不是把编辑器和预览拆成两栏,而是让源码与成品在同一处叠合——你始终在改的是纯文本,看到的却是成品。

你写 Markdown,它当场成型——标题放大、粗体斜体、行内代码、链接、列表、引用、表格、任务清单都落字即成形。光标离开某段时,#、*、反引号这些标记自动隐藏,只留渲染效果;光标移回那一行,标记又露出来供你编辑。既看得到成品、又随时能改源码,且全程是纯文本。

写作工具栏与快捷键

不想背 Markdown 语法,也能用好 Markdown——工具栏把每个标记做成一次点击。

编辑区上方的两行工具栏一键插入:标题、加粗、斜体、删除线、行内代码、高亮、链接、图片、表格、代码块、数学公式、列表、任务清单、引用、分割线。

  • 常用三件带快捷键：⌘B 加粗、⌘I 斜体、⌘K 链接。
  • 更多排版命令在顶部「格式」菜单（含一/二/三级标题 ⌘1/⌘2/⌘3）。
  • 正文里右键有中文菜单（剪切 / 复制 / 加粗 / 标题 / 插入表格 / 查找等）。

可折叠标题

文档一长,导航就是效率。折叠让你把几十万字压成一份可点开的目录。

鼠标移到任意标题行,行首出现小三角,点一下把这个标题下的整段(到下一个同级或更高级标题前)折叠起来,标题后留「…」提示;再点展开。想一次收起/展开全文,用「显示」菜单 → 折叠所有标题 / 展开所有标题。配合左侧文档大纲,几十万字也能快速跳转。

表格

表格是 Markdown 里最费手的地方,MaxInk 把它变成「像用表格软件一样」——而源码依然是干净对齐的纯文本。

工具栏「插入表格」放一个起始表格;表格实时渲染成真正的表样,光标移入显示源码方便改、移开即恢复渲染。v0.11.0起升级为可视化就地编辑:点单元格直接打字,Tab / Shift+Tab / 方向键在格间移动,最后一格按 Tab 自动新增一行,悬浮菜单增删行列。表格源码始终保持对齐(自动处理中文宽度)。

源码 / 专注 / 打字机

同一份文稿,三种进入状态:看清语法、屏蔽干扰、长文久坐——按「显示」菜单随时切换。

源代码模式 ⌘ /

暂时关掉实时渲染,只看纯 Markdown 源码。

专注模式

暗化非当前行,只亮你正在写的那行。

打字机模式

当前行始终保持在屏幕中央,长文写作不用一直往下看。

完整渲染

技术写作要的那些格式,MaxInk 一项不缺,而且都是边写边出——不必导出去别处看效果。

Markdown 该有的,MaxInk 都边写边渲染:

  • 数学公式：行内 $...$、块级 $$...$$（KaTeX）。
  • Mermaid 图表：```mermaid 围栏里写流程图 / 时序图，自动出图。
  • GitHub 警告框：> [!NOTE] / [!TIP] / [!WARNING] 等，带图标配色。
  • 脚注 [^1]、目录 [toc]、YAML frontmatter 信息卡、上下标、==高亮==、emoji。
  • 代码块：语言标注 + 一键复制。

文件嵌入（Content Blocks）

长文档不必塞进一个大文件。用一行语法把小文件拼成长文,每一块仍是文件夹里独立、可复用的普通文件。

单独一行写 ![[文件名]],就把另一个文件嵌进当前文档——可以是 Markdown、图片、代码或 CSV,按文件引用组合长文档。借鉴 iA Writer:不进 vault、不进数据库,就是你文件夹里的普通文件。导出 PDF / Word / HTML 与阅读模式都会把嵌入内容一并带上。

阅读模式

写完要通读、要给人看时,切一下就得到一份干净的高保真版面——而且它和你导出的 PDF / Word / HTML 是同一套渲染。

点工具栏右侧「阅读」钮(或显示菜单 → 阅读模式,⌘⇧R),切到整篇高保真只读视图:数学、Mermaid、代码、表格、嵌入文件全部渲染,排版干净,适合通读、审阅、给人看。按 Esc 退出。导出 PDF / Word / HTML 与阅读模式同一套渲染,所见即所得。

用 MaxInk 编辑 OKF 知识库

当行业开始把「知识」定义成一个不绑云、不绑数据库的文件夹时,MaxInk 从第一天坚持的纯文本路线,恰好就是它的原生工作台。

OKF(Open Knowledge Format)是 Google Cloud 于 2026 年 6 月发布的开放规范:把团队知识表示成一个文件夹里的标准 Markdown + YAML frontmatter,不绑云、不绑数据库、不绑账号,git 能管、任何 AI agent 都能直接消费。这正是 MaxInk 从第一天就在做的事——一个 OKF 库就是一个普通目录,直接用 MaxInk 打开来读写。

  • YAML frontmatter 渲染：文档顶部 type / title / tags 渲染成信息卡。
  • 直接编辑文件夹：把整个 OKF 目录加进侧栏浏览、编辑、递归全文搜索，文件原样留在磁盘。
  • OKF 工作台v0.7.0：侧栏「OKF」面板做确定性合规检查（frontmatter 缺没缺 type、tags 是否列表、嵌入/链接有没有断，零 AI、点一条跳到那一行）；「编辑 frontmatter」像填表一样改字段，不用手敲 YAML。
任何 Markdown 编辑器都能打开 OKF 的 .md，但 MaxInk 是少数为 OKF 提供合规校验 + 可视化 frontmatter + 免建库专属工具的编辑器。MaxInk 与 Google、OKF 无隶属关系。

打开 · 保存 · 标签页

单文件也好、整个文件夹也好,MaxInk 都当作磁盘上的真实文件来管;多标签页让你像浏览器一样同时开好几篇。

工具栏三个主操作:打开(⌘O)单个文件、文件夹把整个目录加进左侧栏、保存(⌘S)。左侧栏顶部可切「文件 / 大纲 / OKF」三页,⌘\ 折叠侧栏。

多文件标签页v0.7.0:编辑区上方一排标签,同时开多个文件、点标签来回切换,每个标签各自保留内容、未保存状态与撤销历史。新建 ⌘N、关闭标签 ⌘W、关闭窗口 ⇧⌘W;标签上小圆点表示有未保存改动。

文件恢复 · 外部编辑自动刷新

纯文本的另一面是安全:意外退出不丢稿,别的工具改了文件也能即时跟上,而且从不悄悄覆盖你手上的内容。

万一 App 意外退出、或没保存就关掉——MaxInk 有安全网:崩溃/未保存内容v0.11.1会在新标签页里打开,不覆盖你当前正在编辑的文件。文件被外部工具改动时,MaxInk 通过系统文件事件即时跟随刷新、更省电。

恢复内容永远落在新标签页,不会盖掉你手上正在写的那份;要不要合并、保留哪一版,由你决定。

图片 · 导出 · TextBundle

写完要把成品交出去:导成通用格式、连图片一起打包带走——始终是文件对文件,不留在某个库里。

  • 图片：粘贴图片自动存盘；支持相对路径、HTML <img>（含 zoom / width 缩放）、微信等沙盒目录里的图片，可拖右下角缩放。
  • 导出：一键存 PDF（原生导出、按 A4 分页、不弹打印面板）/ Word / HTML；装了 pandoc 还能出 EPUB / LaTeX / RTF。
  • TextBundle / TextPackv0.7.0：把文档连引用的图片打成一个文件夹或单文件带走、发给别人；导入即落新标签，图片原样跟随。纯文件、不进库。
读微信等沙盒目录里的文档时，若图片显示不出，到设置 → 完全磁盘访问一键前往系统设置开启，一次永久生效。

设置 · 主题 · 自动更新

让编辑器贴合你的眼睛和习惯,然后交给它自动保持最新——这些都在设置里一次调好。

  • 主题与字号：跟随系统 / 浅色 / 深色三态切换，⌘+ ⌘− ⌘0 或触控板捏合调字号；正文宽度（窄 / 中 / 宽）与正文字体（系统 / 衬线 / 等宽）可选。
  • 设为默认打开方式：设置 → 默认打开方式一键设定。
  • 自动更新：有新版本自动提示，一键下载安装并重启。

数据与隐私

最好的隐私政策是「没有可采集的东西」:文件全在你自己的磁盘和 git 里,软件根本不联网。

你的文件就是标准 .md,原样留在你自己的文件夹和 git 里,绝不进 vault 或专有数据库。MaxInk 不联网、不采集、不收集任何数据。软件已 Apple 签名并公证。

数据所有权始终在你手里:换掉 MaxInk 不需要「导出」这一步——文件本来就一直在你的目录里。

快捷键速查

最常用的一组键位,记住它们就能全程双手不离键盘。

操作快捷键
加粗 / 斜体 / 链接⌘B / ⌘I / ⌘K
一 / 二 / 三级标题⌘1 / ⌘2 / ⌘3
打开 / 保存 / 新建标签 / 关闭标签⌘O / ⌘S / ⌘N / ⌘W
查找替换 / 源码模式 / 阅读模式 / 折叠侧栏⌘F / ⌘/ / ⌘⇧R / ⌘\

常见问题

用之前最常被问到的四件事,一次答清。

MaxInk 会把我的文件锁进它自己的库吗？

不会。你的文件就是标准 .md，原样存在你自己的文件夹里，随时用任何工具打开、随时带走——不建库、不进专有数据库、不联网。

为什么双击 .md 没有用 MaxInk 打开？

系统里 .md 的默认程序是别的。到设置 → 默认打开方式点「设为默认」，或在 .md 上右键「显示简介 → 打开方式 → 全部更改」选 MaxInk。

大文件真的不卡吗？

只渲染视口内可见内容、其余按需加载，百万字文档载入也在几十毫秒、按键在一帧内。

支持哪些系统？

macOS 10.15+（Apple Silicon 与 Intel 通用）与 Windows 10 / 11（64 位，已 Certum 数字签名）。各平台安装包见下载页。

还有问题？联系润迅获取支持。