Guide · Switching from Obsidian

Bring your Obsidian vault.

If you built a Bible-study vault in Obsidian, the good news is structural: your vault is already a folder of markdown files, and markdown files are exactly what Selah imports. No export step, no conversion — and your vault stays untouched.

Step 1 — find your vault

An Obsidian vault is a plain folder of .md files on your disk — that is one of the reasons you chose it. Open the folder in your file browser. There is nothing to export; the files are the notes.

Step 2 — import into Selah

Sign in and open the importer. Select your .md files — you can drop in many at once, up to 5MB each and 50 notes per batch; a larger vault imports in a few rounds. Each file becomes one note in Selah, titled from its first heading or its filename. Importing copies your files; it never moves or edits them.

Step 3 — watch your map appear

After the import, Selah reads each note and maps the concepts in it — people, places, doctrines, themes — onto your belief map. Where Obsidian connects notes by the links you typed, Selah connects them by what they say. The linking you used to do by hand starts happening from the words themselves.

What carries over, exactly

A truthful list, because you would find out anyway:

Formatting comes across.Headings, bold, italic, lists, blockquotes, links, tables, and code blocks all arrive in Selah's editor as formatting.

Wikilinks arrive as text.[[Links like this]] are kept as plain text in this first version — readable, not clickable. Nothing is lost, but the link syntax is not interpreted; Selah builds its connections from the note's content instead.

Frontmatter arrives as text. YAML frontmatter at the top of a note is kept as plain text at the top of the imported note (its --- fences render as divider lines). Tags and properties are not interpreted yet.

Attachments stay behind. Embedded images and other attachments do not come across in this first version.

Why move at all

Obsidian is a fine home for notes. What it does not have is a reader, a prayer board, or a companion — so Bible study there means maintaining the plumbing yourself. Selah is that vault with the study built in, and the same exit door: everything exports back to plain markdown, anytime. If you ever leave, you leave with a folder of .md files — exactly what you arrived with.

Your vault, with the study built in

Import your notes and see your belief map take shape from what you already wrote. Free to start, and everything exports back to markdown.

Start free

Free to start. No credit card.