Open a folder written in Obsidian

There is no import step. Writ reads the folder where it is, and Obsidian keeps working from it.

1. Point Writ at the folder

Settings, Notes, Notes folder: choose the folder Obsidian was using. Writ reads it once, then follows changes on disk. Nothing is copied, converted or rewritten. To try it without changing your notes folder, start Writ with WRIT_NOTES_DIR set to the folder instead.

2. What carries over

• Folders, file names and the markdown itself. The files are the notes; nothing moves.
• [[Note]], [[Folder/Note]], [[Note|a label]] and [[Note#Heading]] all open the note. When two notes share a name, both are offered; Writ never picks one for you.
• Links pointing at a note appear in the Connections panel, with the sentence each one sits in.
• Frontmatter key: value pairs are properties. A nested map is kept as written and shown as text.
• #tag in the text, and tags: in the frontmatter as a list or one line. #project/alpha is one tag, listed under project. Tags fold to lowercase, so #Project and #project are one. A tag inside a code fence is left alone.
• Headings become the outline beside the note and the anchors links point at.
• > [!note], > [!warning] and the other callout types, aliases included. One written closed shows its title only.
• ![[Note]] shows the note in the page, up to three embeds deep. ![[image.png]] shows the image.
• Mermaid fences, $x^2$ math, tables, task lists and footnotes render. Nothing is fetched from the web.

3. What does not

• .obsidian/: appearance, hotkeys, plugin settings. Set them again in Writ. The folder is skipped whole and never written to, so Obsidian keeps working from it.
• Community plugins. None run. A note a plugin wrote shows the text the file holds, so a Dataview query or a Templater tag renders as the characters it is.
• .canvas files open as the text they hold. Keep the drawing in Obsidian.
• obsidian:// links are not opened. Rewrite the ones worth keeping as [[Note]].
• aliases: is kept as a property, but a link that names an alias finds nothing. Link by file name, or rename the note.
• Block references, [[Note#^a1b2]], open the note at its top. Embedding one section shows the whole note.
• .trash/ is skipped. To bring a note back, move the file out of it.

4. Using both

Writ writes only notes into the folder: files you create and files you edit. Its settings and index live in its own data folder. If both apps have the same note open, the last save wins, so keep one of them closed on that note. If a file changes under Writ, a save that would overwrite it is refused and your text lands beside the note as a conflict copy.

What stays in Obsidian

Canvas, plugins, templates, block references, Obsidian Sync and Publish. See Writ next to Obsidian.