Resomark 帮助中心

Resomark 是 Mac 上的 Markdown 编辑器:直接打开你电脑上的文件夹,边写边显示排版;你的 AI 工具改了文件夹里的文件,它标出改了哪里,由你决定留下还是改回。这里是它的使用说明,一页回答一个问题。

第一次用,按顺序看这几页:安装与更新 → 快速上手 → 和你的 AI 一起用。从 Obsidian 过来的,先看从 Obsidian 换过来。

找不到答案,见遇到问题怎么办。

开始使用

  • Resomark 是什么

    Resomark 是 Mac 上的 Markdown 编辑器:直接打开你电脑上的文件夹,边写边看排版,并标出你的 AI 工具改了哪里,由你决定留下还是改回。

  • 安装与更新

    Resomark 需要 Apple 芯片或 Intel 的 Mac 和 macOS 15 或更新版本。从 resomark.com 下载安装,之后会在后台自动更新。

  • 快速上手

    装好 Resomark 后,先把一个你已经在用的文件夹添加为工作空间,再打开里面的文件读和写;你的 AI 工具改了这个文件夹,侧栏会列出改动。

  • 和你的 AI 一起用

    让能改你电脑上文件的 AI 工具(如 Claude Code、Codex)在文件夹里干活,再用 Resomark 打开同一个文件夹看它改了什么,不用连接或插件。

  • 界面一览

    Resomark 的窗口从左到右是侧栏、编辑器和右侧检查器,上面是工具栏和标签栏。这一页说明每一块叫什么、怎么打开收起,以及标签和窗口的用法。

  • 从 Obsidian 换过来

    不用导入:把 Obsidian 仓库当普通文件夹添加为工作空间。双链、Callout、frontmatter 照常;插件、嵌入笔记、标签面板没有。

工作空间

  • 工作空间是什么

    工作空间就是你添加到侧栏的一个真实文件夹,也是搜索、链接、追踪改动和历史的范围。数量不限、免费;移除只是从侧栏拿掉,不动磁盘上的文件。

  • 几种工作空间

    工作空间按谁来记改动分三种:Git 仓库、打开了「追踪更改」的文件夹、不追踪的文件夹。种类决定你看得到哪些改动、能不能保留还原、有哪几种历史。

  • 收藏

    在侧栏里右键文件选「添加到收藏」,它就出现在侧栏首页和所在工作空间的「收藏」里。收藏只放文件,文件夹用置顶。收藏记在工作空间里,换台 Mac 打开也在。

  • 置顶文件夹

    工作空间里常去的子文件夹,右键选「置顶文件夹」,它就出现在侧栏首页、所属工作空间的下面,一点就到。置顶只是入口,搜索、链接和改动仍按整个工作空间算。

  • 远程工作空间(SSH)

    通过 SSH 打开服务器或另一台电脑上的文件夹,像本机的工作空间一样浏览、编辑和看改动。用你已经配好的 SSH 登录,文件和历史都留在那台电脑上。远程工作空间是 Plus 功能。

文件与搜索

  • 能打开哪些文件

    Markdown、纯文本和代码可以编辑;PDF、图片、网页、Office 文档和音视频可以在 App 里看,不能改;压缩包、安装包交给别的 App。

  • 搜索

    按 ⌘P 打开搜索,在一个面板里按名字找文件、文件夹、工作空间和命令,选中后直接打开、移动或执行。默认搜当前工作空间,正文按需现扫。搜索全部免费。

看改动与历史

  • 三种历史

    三种历史:Git 的提交、macOS 存的 Mac 版本、Resomark 给不在 Git 里的文件夹记的工作空间历史。谁记、存在哪、要不要 Plus 各不相同。

  • 追踪更改

    不在 Git 里的文件夹打开「追踪更改」,Resomark 从这一刻记下内容,之后别的 App 改的都列出来等你确认,退出 App 也照样追踪。Plus 功能。

  • 保留与还原

    AI 改了文件,在正文里一处处看:对的按「保留」,错的按「还原」;也能整个文件、选中的几个或全部一起处理。还原就是丢掉那处修改。这是 Plus 功能。

  • Git 仓库里的未提交改动

    把 Git 仓库的根文件夹添加为工作空间,侧栏和正文里就标出还没提交的改动,对比最近一次提交,免费。Resomark 只读 Git,不替你暂存、提交或丢弃改动。

  • 在正文里看差异

    「显示差异对比」(⇧⌘D)决定正文里标不标改动:Git 仓库对比最近一次提交,追踪更改的文件夹对比你认可过的内容。默认开着,可切换行内或分栏。

  • 提交历史

    Git 仓库的大标题旁有「提交历史」:选一个提交,看它改了哪些文件、每个文件改了什么。列表免费,打开提交是 Plus。看历史不切分支、不动你的文件。

  • worktree 与分支

    Git 仓库文件夹页顶部的 worktree 按钮,点开可以切换 worktree,或给当前 worktree 换分支。Plus 功能,不替你提交或丢弃改动。

  • 工作空间历史

    打开了「追踪更改」的工作空间,大标题旁的时钟就是工作空间历史:整个文件夹按时间排成一个个存档,能搜索、能打开看改了什么,也能手动添加存档。这是 Plus 功能。

  • 单个文件的历史

    打开文件,点工具栏的「历史」或按 ⌥⌘\,在右侧看它的旧版本:预览、比较、恢复。来源有 Git、Reso、Mac 三种,恢复前都先替你存一份。

读和写

  • 边写边看

    Markdown 文件默认边写边显示排版:光标所在的那一行露出原文,其余是排好的样子。还能切换源码模式、只读模式、全宽和文字大小。停下、切走或关闭时自动保存。

  • 支持的 Markdown

    支持 CommonMark 和 GitHub 风格的 Markdown,外加高亮、脚注、公式、Mermaid、Callout 和双链。文件就是普通的 .md。

  • 链接与反向链接

    输入 [[ 补全工作空间里的文件名,生成双链,单击就跳过去。右侧检查器的「信息」里列出谁链到了这一篇(反向链接)和它链出去的文件。

账号与付费

  • Free、Plus 与 14 天试用

    读写、浏览、搜索和 Git 里看未提交改动都免费,没有期限;追踪更改、版本历史、Git 提交与切换、远程和更多字体是 Plus,可免费试用 14 天。

  • 订阅、设备与退款

    用 Apple 或 Google 账号登录后订阅 Plus,按月或按年付,最多 3 台 Mac。随时在「设置」→「账号」里取消;每次扣款后 14 天内可全额退款。

隐私与帮助

  • 你的文件在哪、会不会上传

    文件留在原来的文件夹里,Resomark 不导入、不上传,我们收不到文件内容和文件名。它只在工作空间里放一个 .resomark 文件夹,历史存在本机。

  • 遇到问题怎么办

    出错了用「帮助」→「报告 Bug…」告诉我们;有问题用「和我们聊聊…」或写信到 support@resomark.com;想提建议用「功能建议…」。