focalboard/import/notion/README.md

# Notion importer

This node app converts a Notion CSV and markdown export into a Focalboard archive. To use:
1. From a Notion Board, open the ... menu at the top right
2. Select `Export` and pick `Markdown & CSV` as the export format
3. Save it locally, and unzip the folder e.g. to `notion-export`
4. Run `npm install` from within `focalboard/webapp`
5. Run `npm install` from within `focalboard/import/notion`
6. Run `npx ts-node importNotion.ts -i <path to the notion-export folder> -o archive.focalboard`
7. In Focalboard, click `Settings`, then `Import archive` and select `archive.focalboard`

## Import scope

Currently, the script imports all cards from a single board, including their properties and markdown content.

The Notion export format does not preserve property types, so the script currently imports all card properties as a Select type. You can change the type after importing into Focalboard.

[Contribute code](https://www.focalboard.com/contribute/getting-started/) to expand this.
Import scripts 2021-02-16 20:34:58 +01:00			`# Notion importer`

Import from Notion 2021-02-22 19:58:50 +01:00			`This node app converts a Notion CSV and markdown export into a Focalboard archive. To use:`
			`1. From a Notion Board, open the ... menu at the top right`
			2. Select `Export` and pick `Markdown & CSV` as the export format
			3. Save it locally, and unzip the folder e.g. to `notion-export`
Update import build instructions 2021-04-13 23:35:50 +02:00			4. Run `npm install` from within `focalboard/webapp`
			5. Run `npm install` from within `focalboard/import/notion`
			6. Run `npx ts-node importNotion.ts -i <path to the notion-export folder> -o archive.focalboard`
			7. In Focalboard, click `Settings`, then `Import archive` and select `archive.focalboard`
Import scripts 2021-02-16 20:34:58 +01:00
Import from Notion 2021-02-22 19:58:50 +01:00			`## Import scope`

			`Currently, the script imports all cards from a single board, including their properties and markdown content.`

			`The Notion export format does not preserve property types, so the script currently imports all card properties as a Select type. You can change the type after importing into Focalboard.`

			`[Contribute code](https://www.focalboard.com/contribute/getting-started/) to expand this.`