Switch from Obsidian

Your Obsidian vault is already an ordinary folder on your computer, full of Markdown files. Resomark doesn't import or convert anything: add that folder as a Workspace and you can read and write the notes in it directly. Obsidian and Resomark can have the same folder open at the same time, working on the same files. If you stop using Resomark, the folder is just as it was, and Obsidian opens it as usual.

1. Find the folder your vault is in, in Finder.
2. In Resomark, choose File > Add Workspace… and pick that folder. You can also drag the folder straight onto the sidebar's Home page.
3. In the add window: if the vault is a Git repository (because you sync it with a Git plugin, for example), the card says Git repository and changes come straight from Git. If it isn't, you can turn on Track Changes, so you'll see which notes your AI tools or other apps changed. See Kinds of Workspace.

• Markdown: headings, lists, task lists, tables, code blocks, quotes.
• Wikilinks: [[note]], [[note|alias]], [[note#heading]], [[#heading]], [[note#^block]]. Typing [[ completes file names, and aliases in frontmatter are recognized too. See Links and backlinks.
• Backlinks: see which notes link to this one in Info, in the Inspector on the right.
• Image embeds: ![[image.png]] and ![](image.png) both show the image.
• Callouts: > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING], > [!CAUTION].
• Frontmatter: the YAML properties at the top of a file are kept and shown as they are.
• Other syntax: ==highlight==, footnotes, $math$ and $$math$$, Mermaid diagrams.
• Attachment folder: if you keep attachments in an attachments folder in Obsidian, set Images in a Workspace to Workspace's attachments/ folder in Settings > Editor, and newly pasted images go there too.

The full syntax table is in Supported Markdown.

• Note embeds: ![[note]] doesn't embed the content of that note.
• Only the five callouts above: other types such as [!info] and [!question] show as ordinary quotes.
• Tags: #tag is plain text, and there's no tag pane.
• Plugins, themes, Canvas, graph view, daily notes: Resomark has none of these. Code blocks that plugins put in notes (Dataview queries, for example) show as code.
• Sync: Resomark doesn't sync files. Whatever you used before, whether Obsidian Sync, iCloud or Git, keeps syncing the folder; Resomark only reads and writes the files on disk.

Obsidian keeps its settings in the .obsidian folder inside the vault. Resomark doesn't change it. It's a hidden folder, so the sidebar doesn't show it by default.

While Obsidian is open, it rewrites files in .obsidian from time to time, such as workspace.json, which records the window layout. With Track Changes on, these don't count as changes: the whole .obsidian folder, and the .trash folder where Obsidian puts deleted notes, never appear in Changes, and the ⓘ next to the Changes heading lists them among the folders not tracked. If the vault is a Git repository, Git's rules apply: when files in .obsidian that aren't in .gitignore change, they show up in Changes.

Resomark adds a .resomark folder of its own to the Workspace to record Favorites and Pinned Folders; Obsidian isn't affected. See Where are your files, and are they uploaded?.

• Quick start
• Supported Markdown