Importing and exporting your Vault
Your Vault is plain Markdown. Download all of it as a .zip at any time, and bring in notes and Boards from other Markdown note apps.
3 min read
ExportingCopy link to this section
At the top of the Vault, press Export .zip. The download starts straight away, however large your Vault is. It holds:
- Notes as
Folder/Title.md, in your own folders. At the top of each file are its tags, aliases, details and the dates it was created and last changed. - Links exactly as you wrote them, such as
[[Note#Heading]], so they keep working in other apps that read Markdown links. - Boards as
.canvasfiles, with each note card pointing at the note's file. - Attachments in an
attachmentsfolder, each file once.
Characters that some computers do not allow in file names are replaced with a dash. If two notes would get the same file name, the second gets (2) and the links to it are changed to match. No settings of any other app are written.
Your Vault is also in the file Download my data gives you; see Privacy controls for members.
ImportingCopy link to this section
- Press Import and choose a .zip of a Markdown vault, or loose
.md,.markdown,.txtand.canvasfiles. Vaults made by other Markdown note apps work. - Choose what happens when a note with the same title is already there: Skip it, Rename the new one with (2), or Overwrite the old one (its earlier text is kept in its history).
- Everything is checked first, then brought in in batches. You can leave the page; an import that stops part-way can be resumed.
- At the end, a report lists every file: imported, skipped, or the reason it could not be.
What is carried overCopy link to this section
- Tags, aliases and other details at the top of a file, and #tags in the text.
- Links, found by folder and title, then by title, then by alias. A link to a note that is not in the import stays as a link to a note not created yet.
- .canvas files become Boards, with their cards in the same order and colours. A card pointing at a file that is not in the import becomes a text card reading Missing, and the report lists it.
- Images, PDFs and sound files become attachments, after a check for harmful content.
- Other apps' settings folders, their trash folders, drawings and plugin data are skipped, and the report says so.
Limits and safetyCopy link to this section
An import refuses a .zip with file paths that try to leave its folder, and one that would expand to far more than its own size. The number and size of files you can import follow your plan and your workspace's settings; see Limits and quotas. An import that would pass your note limit stops before it changes anything.
Last updated