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
- Make a copy of the folder first. It costs nothing and means you can compare the two apps side by side.
- In mdai choose File → Open Vault… and pick the copy.
- Look at the Files panel. Your folders and notes are there, with names shown without
.md. - Click Todo, Tags and Calendar in the panel: they are built from what is already in your notes.
- 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
- Wikilinks and backlinks.
[[Note]], links to a heading and embeds of a heading or a block work, and each note shows what links back to it. - Tasks. Every
- [ ]and- [x]is collected into one Todo panel. Dates written as@2026-10-02and#tagson the task line are read too. - Tags. Inline
#tagsand thetags:key in the frontmatter, including nested ones like#client/acme. - Properties. The frontmatter block is shown above the note and in a Properties panel.
- Callouts, tables, math and Mermaid diagrams.
- Hidden folders. Folders whose name starts with a dot, such as
.obsidian, are left out of the file tree and the search.
What you will need to adjust
- Plugins. mdai does not run Obsidian community plugins. Notes written with plugin syntax stay in your files as text. A query block, such as Dataview’s, is shown as a code block with its text kept exactly as written; mdai does not run it.
- Obsidian’s Bases and Canvas files (
.base,.canvas) are not listed: mdai’s file tree shows Markdown files only (.md,.markdown,.mdown,.mkd). - Task lists. If you used a plugin to gather tasks, mdai’s Todo panel and Calendar do that without one. The line format is the same checkbox Markdown.
- Sync. If you used Obsidian’s paid sync, put the vault in iCloud Drive, Google Drive, Dropbox or Syncthing instead. mdai picks up changes made by the sync tool.
- Typora users: Typora has no wikilinks or tags of its own, so there is nothing to convert. You can start using
[[ ]]and#tagswhen you want to.
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.