Import data into Swimm
We imagine that you likely have lots of docs spread across multiple apps and files. Rather than creating new docs from scratch, you can import all your existing documentation into Swimm. This will ensure that your docs will be easy to find and stay up to date.
How to import dataβ
Step 1β
Click Create
button in the top right corner of your repo page on Swimm.
Step 2β
Navigate to the Import
tab in the create with options.
Choose one of the different import options in the hub:
- Upload .md files
- Repo Import
- Notion Import
- Confluence Import
Step 3β
Follow the import wizardβs instructions to begin importing your data.
Instructions for each import optionβ
Upload .md filesβ
Follow these instructions to import Markdown files from your computer:
- Start by navigating to the Swimm workspace where you'd like to import your markdown files.
- Next, go to your Swimm repo page and click the
New
button in the upper right-hand corner. - Go to the Import Section and select the
Upload .md files
option. - Click
Upload
and select the .md files you wish to import. Note that you can select multiple files. - Follow the import wizard instructions.
Repo importβ
Follow these instructions to import Markdown files from your repository:
- Start by navigating to the Swimm workspace where you'd like to import your markdown files.
- Next, go to your Swimm repo page and click the
New
button in the upper right hand corner. - Go to the Import Section and select the
Repo import
option. - Select the .md files you wish to import from your repo.
- Follow the import wizard instructions.
Confluence importβ
Follow the instructions below to import Confluence data:
1. Export your Confluence space to HTML.β
You must be an admin of the space in Confluence in order to export content from Confluence.
If you are not an admin, you can copy and paste the contents of the docs you would like to import.
- Log into Confluence and choose the space you want to export.
- Select
Space Settings
on the left sidebar. - In the Manage Space section, choose
Export Space
. - Select
HTML
from the list of formats. - Select
Custom Export
and un-check theInclude Comments
box. - Select which pages you want to export. Keep in mind that large attachments will complicate the export process and size.
- Wait for your export to finish. This may take a while.
- After the export is done, click
Download here
to save it to your computer. - You will see a file titled something like
Confluence-space-export-XXXXXX.html.zip
, whereXXXXXX
is a sequence of digits
2. Import your Confluence space to Swimm.β
- Start by navigating to the Swimm workspace where you'd like to import your Confluence content.
- Next, go to your Swimm repo page and click the
New
button in the upper right hand corner. - Go to the Import Section and select the
Confluence Import
option. - In the file picker, navigate to the .zip file exported from Confluence in the previous step, and select it for upload. Unzipping is not required - just upload the entire zip file.
- Follow the import wizard instructions to complete the import process.
Notion Importβ
Follow the instructions below to import Notion data:
1. Export your Notion space to Markdown files.β
- Log into Notion and choose the workspace you want to export.
- Go to
Settings & Members
at the top of your left-hand sidebar. - Select
Settings
in the sidebar of that window. - Scroll down and click the
Export all
workspace content button. - In the
Export format
, selectMarkdown & CSV
- Un-check the
Create Folders and Sub-folders
box. - Click
Export
. - Your download will begin automatically, and you'll also receive an email from Notion with a link to download your files.
2. Import your Notion space to Swimm.β
- Start by navigating to the Swimm workspace where you'd like to import your Notion content.
- Next, go to your Swimm repo page and click the
New
button in the upper right hand corner. - Go to the Import Section and select the
Notion Import
option. - In the file picker, navigate to the .zip file exported from Notion in the previous step, and select it for upload. Unzipping is not required - just upload the entire zip file.
- Follow the import wizard instructions to complete the import process.
This document is automatically kept up to date using Swimm.