Resomark Help Center
Resomark is a Markdown editor for the Mac. It opens the folders already on your computer and shows the formatting as you write. When your AI tools change files in those folders, it marks what changed, and you decide whether to keep each change or change it back. This is its user guide, one question per page.
New to Resomark? Read these pages in order: Install and update → Quick start → Work with your AI. Coming from Obsidian? Start with Switch from Obsidian.
Can't find an answer? See If something goes wrong.
Get started
- What is Resomark
A Markdown editor for the Mac that opens the folders on your computer, formats as you write, and marks what your AI tools changed so you can keep or revert it.
- Install and update
Resomark needs a Mac with Apple silicon or Intel and macOS 15 or later. Download it from resomark.com; after that, it updates itself in the background.
- Quick start
Add a folder you already use as a Workspace, then open its files to read and write. When your AI tools change that folder, the sidebar lists what changed.
- Work with your AI
Let an AI tool such as Claude Code or Codex work in a folder on your Mac, then open that folder in Resomark to see what it changed. No plugin needed.
- Interface overview
The Resomark window has the sidebar, editor and Inspector, with the toolbar and tab bar above. What each part is called, how to show it, and how tabs work.
- Switch from Obsidian
Nothing to import: add your Obsidian vault as a Workspace. Wikilinks, callouts and frontmatter work; there are no plugins, note embeds or tag pane.
Workspaces
- What is a Workspace
A Workspace is a real folder in your sidebar and the scope for search, links, tracking and history. Unlimited and free; removing one leaves your files alone.
- Kinds of Workspace
Three kinds, by who records changes: a Git repository, a folder with Track Changes on, or an untracked one. The kind decides what changes and history you see.
- Favorites
Right-click a file and choose Add to Favorites to list it on the Home page and in its Workspace. Favorites hold files, not folders, and stay with the folder.
- Pinned Folders
Pin a subfolder to list it under its Workspace on the Home page. A pin is only a shortcut: search, links and changes still cover the whole Workspace.
- Remote Workspaces (SSH)
Open a folder on a server or another computer over SSH, and browse, edit and review changes as in a local Workspace. Uses the SSH login you already have; files and history stay on that computer. Part of Plus.
Files and search
- Which files Resomark opens
Markdown, plain text and code can be edited. PDFs, images, web pages, Office documents, audio and video open read-only. Archives go to other apps.
- Search
Press ⌘P to find files, folders, Workspaces and commands by name, then open, move or run what you picked. It searches the current Workspace first. Free.
Changes and history
- Three kinds of history
Git commits, the Mac versions macOS keeps, and the Workspace History Resomark records for folders outside Git: who records each, where, and what needs Plus.
- Track Changes
With Track Changes on, Resomark records a folder outside Git from that moment and lists what other apps change for you to confirm, even while closed. Plus.
- Keep and revert
Keep the right changes and revert the wrong ones, one at a time in the text, or a file, a selection or everything at once. Revert discards. Plus.
- Uncommitted changes in a Git repository
Add a Git repository's root folder as a Workspace to see what you haven't committed, marked in the sidebar and the text, for free. Resomark only reads Git.
- See differences in the text
Show Diff (⇧⌘D) decides whether changes are marked in the text: against the last commit in Git, or what you accepted with Track Changes. On by default.
- Commit History
In a Git repository, Commit History is next to the big title. Pick a commit to see which files it changed and how. The list is free; opening commits is Plus.
- Worktrees and branches
The worktree button on a Git repository's folder page switches worktrees or the current worktree's branch. Plus; it never commits or discards for you.
- Workspace History
With Track Changes on, the clock next to a Workspace's title is Workspace History, a timeline of save points you can search, open and add to by hand. Plus.
- History of a single file
Click History or press ⌥⌘\ to preview, compare and restore a file's old versions from Git, Reso or Mac. A copy is saved before any restore.
Reading and writing
- Editing with Live Preview
Markdown shows its formatting as you write, with the source on the cursor's line. Switch to Source Mode, Read-Only Mode or Full Width; saving is automatic.
- Supported Markdown
CommonMark and GitHub Flavored Markdown, plus highlights, footnotes, math, Mermaid, callouts and wikilinks. Your files stay ordinary .md files.
- Links and backlinks
Type [[ to pick a file and make a wikilink; click it to go there. Info in the Inspector lists the files that link here and the ones this file links to.
Account and billing
- Free, Plus and the 14-day trial
Editing, search and uncommitted Git changes are free, with no time limit. Track Changes, history, Git commits and switching, remote and more fonts are Plus.
- Subscription, devices and refunds
Sign in with Apple or Google to subscribe to Plus, monthly or yearly, on up to 3 Macs. Cancel in Settings > Account; full refund within 14 days of any charge.
Privacy and help
- Where are your files, and are they uploaded?
Your files stay in their folders. Resomark doesn't import or upload them, and we never receive their contents or names. History stays on this Mac.
- If something goes wrong
Use Help > Report a Bug… for errors, Chat with Us… or email support@resomark.com for questions, and Suggest a Feature… for ideas.