Open your Obsidian folder in Writ
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, General, Folder, Moveā¦: choose the folder Obsidian uses. The files already in Writ's folder move into it; if a name is in both, nothing moves. Writ reads it once, then follows changes on disk. Nothing in it is copied, converted or rewritten. To try it without changing that setting, start Writ with WRIT_NOTES_DIR set to the folder instead.
2. Switch on the apps you used
Backlinks, the graph and the tag list are apps in Writ, off until you switch them on in Settings, Apps: Connections for the files that link here, the outline and the properties; Graph for the map of the folder; Tags for the tag list in the sidebar.
3. What carries over
- Folders, file names and the Markdown itself.
[[File]],[[Folder/File]],[[File|a label]]and[[File#Heading]]all open the file. When two files share a name, both are offered; Writ never picks one for you.- Frontmatter
key: valuepairs are properties, listed in the Connections panel. A nested map is kept as written and shown as text. #tagin the text, andtags:in the frontmatter as a list or one line.#project/alphais one tag, listed underproject. Tags fold to lowercase, so#Projectand#projectare one. A tag inside a code fence is left alone.- Headings, lists, checkboxes, links, images and code blocks are formatted in Inline mode, with the markup shown on the line you are editing.
- Tables,
$x^2$math and Mermaid fences are drawn in Inline mode, with the source shown while the cursor is in them.
4. What stays as written
- Callouts and
![[File]]and![[image.png]]embeds show as the text they are. .obsidian/: appearance, hotkeys, plugin settings. Writ skips the folder whole and writes nothing there on its own.- Community plugins. None run. A file a plugin wrote shows the text it holds, so a Dataview query or a Templater tag reads as the characters it is.
.canvasfiles open as the text they hold.obsidian://links are not opened. Rewrite the ones worth keeping as[[File]].aliases:is kept as a property, but a link that names an alias finds nothing. Link by file name, or rename the file.- Block references,
[[File#^a1b2]], open the file at its top. .trash/is skipped. To bring a file back, move it out of there.
5. Using both
Writ's settings and index live in its own data folder, not in yours. If both apps have the same file open, a save from Obsidian replaces what Writ saved, so keep one of them closed on that file. If a file changes under Writ, a save that would overwrite it is refused and your text lands beside the file as a dated copy. Writ and Obsidian on one folder lists what each app does there.