How to move your notes from Obsidian or Typora to mdai

Facts about Obsidian and Typora below were checked against their documentation on 13 November 2026.

There is no migration, because there is nothing to convert. Obsidian vaults and Typora folders are ordinary folders of .md files, and so is an mdai vault. You open the folder; your files stay where they are, exactly as they were.

Step by step

  1. Make a copy of the folder first. It costs nothing and means you can compare the two apps side by side.
  2. In mdai choose File → Open Vault… and pick the copy.
  3. Look at the Files panel. Your folders and notes are there, with names shown without .md.
  4. Click Todo, Tags and Calendar in the panel: they are built from what is already in your notes.
  5. Open a note that has [[wikilinks]] and click one.

When you are happy, open the real folder the same way. Close mdai and open the folder in the other app again at any time; nothing was rewritten behind your back.

What works immediately

What you will need to adjust

Quick check after opening

Search the vault for something you know is there, open the graph, and check one note you rely on. If something looks wrong, it is probably plugin syntax; the text is still in your file. Download mdai · Your first vault · Vault and files

FAQ

Do I need to import my vault? No. Open the folder with File → Open Vault…; nothing is converted or copied.

Will mdai change my notes? Only when you edit them. Dates and tags on a task line stay exactly as you typed them; mdai reads them and does not rewrite your lines.

Are wikilinks supported? Yes: [[links]], links to a heading, embeds of a heading or a block, and backlinks.

What happens to the .obsidian folder? Folders whose name starts with a dot are left out of the file tree and the search.