You can import Markdown (.md), plain text (.txt), and Word (.docx) files, or use the dedicated import options for Notion (beta), Obsidian, Roam Research (beta), and Logseq (beta). If your app is not listed, try exporting your notes to one of these supported document formats. Contact us if you need help choosing an import method.

Markdown, text, and Word documents

In the desktop or web app:

Click Import at the bottom of the left sidebar.
Choose Text documents (.md, .txt, .docx).
Select one or more supported files to import.

We recommend the desktop app for faster importing. For an export from Notion, Obsidian, Roam Research, or Logseq, use the matching import option and instructions below. Importing document files does not guarantee that another app’s database structure, links, or formatting will be preserved exactly.

Notion

We currently only support importing partial contents (mainly pages) from Notion.

Select the top-level page you want to export and choose Export from the top-right menu.
Choose Markdown & CSV format, include everything, and check the "Include subpages" box, then press the Export button to download the .zip file.
In Heptabase, choose Import from the bottom of the left sidebar. Choose Notion and upload the .zip file you just downloaded.

Obsidian

Import your entire vault

In Obsidian, you can export all your files all at once.

Open any note in Obsidian. Select “Show in system explorer” by right click on the note.
Navigate the folder to your Obsidian vault’s root folder.
Compress the root folder of your Obsidian vault to a .zip file.
In Heptabase, choose import from the bottom of the left sidebar. Choose Obsidian and upload the .zip file you just compressed.

If you use Windows and have non-English filename, please do not use the default compression function. Instead, you need to use 7zip, Bandzip, etc to compress the files.

For 7zip users, please select "zip" format and type cu=on in the parameters box, as shown below.

Import individual files

Alternatively, you can upload individual markdown files:

In Heptabase, click the import icon at the bottom of left sidebar and choose Obsidian.
Navigate to your Obsidian vault in the popup and select the markdown files you’d like to upload.

What gets imported

The imported files will be processed as following:

All images attachments will be uploaded.
All identifiable wikilink and markdown link (with relative path) will be converted to standard markdown link that Heptabase can use. We identify links based on the imported files.
All inline tags will be imported to Heptabase’s tag system.

Roam Research & Logseq (Beta)

Roam Research

We currently only support importing journals and pages. We do not support importing block level references.

Select Export All from the top-right menu
Choose Markdown format and press the Export All button to download the .zip file.
In Heptabase, choose Import from the bottom of the left sidebar. Choose Roam Research/Logseq and upload the .zip file you just downloaded.

Logseq