MaxInkMaxInk 使用文档
MaxInk 是一款 macOS 原生的轻量 Markdown 读写器：双击秒开任意 .md、边写边渲染、纯文本随时带走、几十万到百万字也不卡。这一页讲清从装机到写作、渲染、阅读、导出、文件恢复与自动刷新的全部用法。
快速开始
MaxInk 主打「轻、不锁、不卡」：你的文件就是标准 .md，存在你自己选的位置，随时用别的工具打开、随时带走，绝不进 vault 或专有数据库；软件免费、签名公证、不联网采集、不收集任何数据。
下载装机
到 下载页 点绿色「下载 MaxInk（通用版）」拿到 .dmg，打开后把 MaxInk 拖进「应用程序」即可。通用版（Universal）一个包同时支持 Apple Silicon 与 Intel Mac，无需区分。首次打开若提示来源，因已 Apple 签名公证，正常打开即可。
双击秒开 / 设为默认
MaxInk 招牌是「双击秒开单个 .md」：已关联 .md / .markdown / .mdown，在访达里双击就直接进 MaxInk 打开那个文件，不必先开 App 再找文件。
.md 的默认程序还是别的（如 VS Code、TextEdit）。到 设置 → 默认打开方式 点「设为默认」一次即可；或在任意 .md 上右键「显示简介 → 打开方式 → 全部更改」选 MaxInk。详见 设为默认打开方式。
行内实时预览
MaxInk 做的是所写即所见：你写 Markdown，它当场成型——标题放大、粗体 / 斜体、行内 代码、链接、列表、引用、表格、任务清单都落字即成形。
光标离开某段时，#、**、反引号这些标记会自动隐藏，只留渲染效果；光标移回那一行，标记又露出来供你编辑。所以你既看得到成品、又随时能改源码，且全程是纯文本。
写作工具栏与快捷键
不想背 Markdown 语法也没关系。编辑区上方的工具栏一键插入：标题、加粗、斜体、删除线、行内代码、高亮、链接、图片、表格、代码块、数学公式、无序 / 有序列表、任务清单、引用、分割线。
常用三件还有快捷键：⌘B 加粗、⌘I 斜体、⌘K 链接。更多排版命令都在顶部「格式」菜单里（含一 / 二 / 三级标题 ⌘1/⌘2/⌘3）。在正文里右键也有中文菜单（剪切 / 复制 / 粘贴 / 加粗 / 标题 / 插入表格 / 查找等）。
可折叠标题
大文件里找内容，靠折叠最快。把鼠标移到任意标题行，行首会出现一个小三角 ▾，点一下就把这个标题下的整段（直到下一个同级或更高级标题之前）折叠起来，标题后留一个「…」提示已折叠；再点 ▸ 展开。
想一次收起 / 展开全文，用「显示」菜单 → 折叠所有标题 / 展开所有标题。配合左侧文档大纲，几十万字也能快速跳转、收放自如。
表格
工具栏「插入表格」放一个起始表格；表格会实时渲染成真正的表样，光标移入显示源码方便改、移开即恢复渲染。在某个单元格上右键可增 / 删行列、设置对齐；表格源码始终保持对齐好看（自动处理中文宽度）。
源码 / 专注 / 打字机
三种写作视图，按「显示」菜单切换：
- 源代码模式（⌘/）：暂时关掉实时渲染，只看纯 Markdown 源码。
- 专注模式：暗化非当前行，只亮你正在写的那行，减少干扰。
- 打字机模式：当前行始终保持在屏幕中央，长文写作不用一直往下看。
完整渲染
Markdown 该有的，MaxInk 都边写边渲染，技术写作一项不缺：
- 数学公式：行内
$...$、块级$$...$$（KaTeX 渲染）。 - Mermaid 图表：
```mermaid围栏里写流程图 / 时序图等，自动出图。 - GitHub 警告框（Callout）：
> [!NOTE]/[!TIP]/[!WARNING]等，带图标配色。 - 脚注
[^1]、目录[toc]、YAML front matter 卡片。 - 上下标
~下~/^上^、高亮==文字==、emoji:smile:。 - 代码块：语言标 + 一键复制按钮。
文件嵌入（Content Blocks）
单独一行写 ![[文件名]]，就把另一个文件嵌进当前文档——可以是 Markdown、图片、代码或 CSV，按文件引用组合长文档。借鉴 iA Writer：不进 vault、不进数据库，就是你文件夹里的普通文件。导出 PDF / Word / HTML 与阅读模式都会把嵌入的内容一并带上。
阅读模式
点工具栏右侧的「阅读」钮（或显示菜单 → 阅读模式 ⌘⇧R），切到整篇高保真只读视图：数学、Mermaid 图表、代码、表格、嵌入文件全部渲染，排版干净，适合通读、审阅、给人看。按 Esc 退出。导出 PDF / Word / HTML 与阅读模式同一套渲染，所见即所得。
用 MaxInk 编辑 OKF 知识库
OKF（Open Knowledge Format，开放知识格式）是 Google Cloud 于 2026 年 6 月发布的开放规范：把团队知识表示成一个文件夹里的标准 Markdown 文件 + YAML frontmatter，不绑云、不绑数据库、不绑账号，git 能管、GitHub 能读、任何 AI agent 都能直接消费。没有压缩格式、没有专有运行时、没有必装 SDK——就是文件，就是 Markdown。
这正是 MaxInk 从第一天就在做的事。一个 OKF 库就是一个普通目录，你可以直接用 MaxInk 打开它来读写：
- YAML frontmatter 渲染：文档顶部的
type/title/tags等字段会渲染成信息卡，一眼看清这篇是什么（详见 完整渲染）。 - 直接编辑文件夹：用「文件夹」把整个 OKF 目录加进侧栏浏览、编辑、递归全文搜索，文件原样留在磁盘，绝不导入专有库。
- 大库也不卡：知识库再大、单篇再长，载入都在几十毫秒、每次按键都在一帧内（见下载页实测基准）。
- 纯文本不锁定：你的库始终是标准
.md文件，随时用别的工具打开、随时带走、随时进 git，OKF 的「可移植」承诺一点不打折（详见 数据与隐私）。
type、tags 是不是列表、嵌入与链接有没有断，零 AI、点一条直接跳到那一行；点面板里的「编辑 frontmatter」还能像填表一样改 type / title / tags，不用手敲 YAML。配合多文件标签页，整组 OKF 文档一个窗口来回切换。任何 Markdown 编辑器都能打开 OKF 的 .md，但 MaxInk 是少数为 OKF 提供合规校验 + 可视化 frontmatter + 免建库专属工具的编辑器。延伸阅读：Google Cloud 官方介绍 OKF · OKF 规范（GitHub）。MaxInk 与 Google、OKF 无隶属关系。
打开 · 保存 · 文件夹
工具栏三个主操作：打开（⌘O）单个文件、文件夹把整个目录加进左侧栏浏览、保存（⌘S）。左侧栏顶部可切「文件 / 大纲 / OKF」三页，按 ⌘\ 可折叠侧栏。状态栏会显示当前文件名，有未保存改动时前面带一个 ● 点。
多文件标签页（v0.7.0）：编辑区上方有一排标签，可以同时开多个文件、点标签来回切换，每个标签各自保留内容、未保存状态与撤销历史。新建标签 ⌘N、关闭标签 ⌘W（关闭窗口改为 ⇧⌘W）；标签上的小圆点表示有未保存改动。再大的文件、再多标签也不卡。
全文搜索
侧栏「文件」页顶部的搜索框可递归全文搜索整个文件夹：输入关键词，结果按文件分组、带行号片段，点一下直接跳到那一行。文档内部找字用 ⌘F（支持查找替换）。
文档大纲
侧栏切到「大纲」页，按标题层级列出全文结构，点任意条目直达对应位置；编辑时大纲实时更新。配合可折叠标题，长文导航非常快。
文件恢复（防崩溃网兜）
万一 App 意外退出、或你没保存就关掉了——MaxInk 有个安全网：有未保存内容时，它会在本机定时存一份恢复快照。下次启动若检测到上次异常退出，右下角会弹出「检测到未保存的内容」，点「恢复」把内容找回来，或「丢弃」忽略。
外部编辑自动刷新
如果你在 MaxInk 之外改了同一个文件（比如 git pull 拉到新版本、或用 Vim / 其它工具编辑后保存），MaxInk 会自动跟随：
- 当前文档没有未保存改动时——静默重新载入最新内容，尽量保留你的光标位置。
- 当前文档有未保存改动时——右下角提示「文件已被外部修改」，让你选「重新载入」（用磁盘上的新版本）还是「保留我的」，绝不默默覆盖你的改动。
图片
把图片粘贴或拖入编辑器即可插入。默认会把图片复制到文档同级的 assets/ 目录（纯文本可带走）；也可在设置 → 图片切到「图床命令」，配一条上传命令（兼容 PicGo 等），插入时自动上传并用返回的 URL。工具栏「图片」按钮也能插入图片语法。
导出
「文件」菜单可一键导出：
- PDF：原生导出，不弹打印面板、直接选位置存盘，矢量、文字可选可搜。
- Word（.docx） 与 HTML：自包含，带上数学、Mermaid 图表与嵌入文件。
- Pandoc 导出：装了系统
pandoc后还能出 EPUB / LaTeX / RTF / reStructuredText。
TextBundle / TextPack 导入导出
想把一篇带图片的文档整个带走或发给别人，单独发 .md 会丢图。TextBundle（textbundle.org 开放格式）把 Markdown 正文连同它引用的图片打成一个包，纯文件、不进任何数据库。文件「TextBundle」菜单：
- 导出为 TextBundle…：生成一个
.textbundle文件夹（内含text.markdown+assets/图片 +info.json）；正文里引用的本地图片会自动复制进assets/并把引用改成assets/图名。 - 导出为 TextPack（单文件）…：同样的内容打成一个
.textpack单文件（zip），更适合发邮件 / 发消息。 - 打开 TextBundle… / 打开 TextPack…：选一个包导入，MaxInk 会把里面的
text.*在新标签里打开，图片原样跟随显示；TextPack 会先解成.textbundle文件夹再打开。
https://…）和锚点不会被打包，只打包本地图片与嵌入。导出的包始终是普通文件夹 / zip，任何支持 TextBundle 的工具（Ulysses、Bear、iA Writer 等）都能打开——你的内容永远带得走。
设置
点右上角齿轮打开设置。
主题与字号
主题三态：跟随系统 / 浅色 / 深色。另有四套配色主题（默认 / 护眼 / Solarized / GitHub）。字号可用设置里的 A− / A+，或编辑时 ⌘+ / ⌘− / ⌘0，还支持触控板捏合缩放。
设为默认打开方式
到设置 → 默认打开方式，点「设为默认」就把 MaxInk 设成 .md 文件的默认程序——之后在访达里双击 Markdown 文件会直接进 MaxInk。首次启动若 MaxInk 还不是默认，右下角也会轻量提示一次，你可以点「设为默认」或「不再提醒」。
自动更新
MaxInk 内置自动更新：有新版本会自动提示，点一下下载安装并重启，永远用上最新版。也可在设置里手动「检查更新」。更新只向 maxta.com 查询版本信息，不涉及你的文件。
数据与隐私
MaxInk 不联网采集、不收集任何数据、不上传、不同步。你的文件是标准 .md，存在你自己选的位置；崩溃恢复快照、设置等少量本地数据存在你本机的应用数据目录里。唯一的联网是自动更新向 maxta.com 查询新版本。
快捷键速查
| 操作 | 快捷键 |
|---|---|
| 新建 | ⌘N |
| 打开文件 | ⌘O |
| 保存 | ⌘S |
| 加粗 / 斜体 / 链接 | ⌘B / ⌘I / ⌘K |
| 一 / 二 / 三级标题 | ⌘1 / ⌘2 / ⌘3 |
| 文档内查找 / 替换 | ⌘F |
| 阅读模式 | ⌘⇧R |
| 源代码模式 | ⌘/ |
| 折叠侧栏 | ⌘\ |
| 字号放大 / 缩小 / 复位 | ⌘+ / ⌘− / ⌘0 |
常见问题
MaxInk 会把我的文件锁进它自己的库吗？
不会。你编辑的就是标准 .md 文件，存在你自己选的位置，随时用别的工具打开、随时带走。MaxInk 不建 vault、不进专有数据库、不上传、不同步。
为什么双击 .md 没有用 MaxInk 打开？
MaxInk 已关联 .md / .markdown / .mdown，但如果系统里 .md 的默认程序是别的（如 VS Code、TextEdit），双击仍会走那个。到设置 → 默认打开方式点「设为默认」，或在某个 .md 上「显示简介 → 打开方式 → 全部更改」设成 MaxInk。
几十万字的大文件会卡吗？
不卡。MaxInk 始终只渲染你眼前可见的内容，视口之外按需加载。实测百万字 .md 载入也只要几十毫秒、每次按键都在一帧（16ms）内。
App 崩溃或没保存就退出，写的东西会丢吗？
有崩溃恢复网兜：有未保存内容时 MaxInk 会定时在本机存一份恢复快照，下次启动若检测到上次异常退出会提示你恢复。这是纯本地的安全网，不是云同步、也不是版本历史。详见文件恢复。
我的数据会上传吗？
不会。MaxInk 不联网采集、不收集任何数据，文件都在你本机。仅自动更新会向 maxta.com 查询新版本。
该选 Apple 芯片版还是 Intel 版？
不用选。MaxInk 是通用版（Universal），一个安装包同时支持 Apple Silicon 与 Intel Mac，下载即用。
MaxInk 支持 Google 的 OKF（开放知识格式）吗？
支持。OKF（Open Knowledge Format）知识库本质就是一个文件夹里的标准 .md 文件加 YAML frontmatter，而 MaxInk 正是为这种纯文本文件夹设计的：直接打开目录浏览编辑、frontmatter 渲染成信息卡、递归全文搜索、再大的库也秒开，文件始终留在你的文件夹和 git 里、不进专有库。OKF Linter、frontmatter 可视化面板、多文件标签页也都已内置。详见 用 MaxInk 编辑 OKF 知识库。