# From Notion (https://openknowledge.ai/docs/migrate/notion) How to export a Notion workspace to Markdown and open it in OpenKnowledge, what carries over, and where the two differ. This guide will cover exporting your Notion workspace to markdown files so that you can access them from OpenKnowledge. OpenKnowledge and Notion differ in a few key ways, so a Notion export needs some cleanup — this guide covers what carries over and what to fix. ## Install OpenKnowledge ### Desktop app (macOS, Windows, Linux) Download the latest version of the OpenKnowledge desktop app. The button picks your platform automatically; its dropdown carries every other build, and the [downloads page](https://openknowledge.ai/download) lists them all. - [macOS (Apple Silicon)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-arm64.dmg) - [Windows (x64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-Setup-x64.exe) - [Windows (Arm64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-Setup-arm64.exe) - [Linux .deb (x64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-amd64.deb) - [Linux .deb (Arm64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-arm64.deb) - [Linux .rpm (x64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-x86_64.rpm) - [Linux .rpm (Arm64)](https://github.com/inkeep/open-knowledge/releases/latest/download/OpenKnowledge-aarch64.rpm) - [Run in your browser (npm)](https://openknowledge.ai/docs/reference/cli) - [All builds and checksums](https://openknowledge.ai/download) ### Web app (any platform, including Intel Macs) Install the [ok CLI](https://openknowledge.ai/docs/reference/cli) with npm: ```bash npm install -g @inkeep/open-knowledge ``` ## Export your workspace from Notion 1. In Notion, click on your workspace in the top left and go to **Settings**. 2. Under **General**, scroll down to **Export**. 3. Set **Export format** to **Markdown & CSV** and leave all the default settings. 4. Download and **unzip** the export folder and move it to your desired location. ## Clean up the export with `ok migrate notion` The [ok CLI](https://openknowledge.ai/docs/reference/cli) ships a cleanup command that resolves format issues with the exported content. By default, the command prints what it would change and writes nothing until you pass `--apply`. ```bash # Preview what would change (writes nothing) ok migrate notion /path/to/unzipped-export # Apply the changes ok migrate notion /path/to/unzipped-export --apply ``` > **Info** > > The desktop app ships the `ok` CLI. The Windows installer puts it on your > `PATH` on its own. On macOS and Linux it installs to `$HOME/.ok/bin`, and a > pre-checked toggle in the first-launch dialog puts it on your `PATH` (on > Linux the package's install script also links `/usr/bin/ok` either way). If > `ok` isn't found, add it from **File → Set up OpenKnowledge > integrations…**, then open a new terminal window. If it's still missing, > add `$HOME/.ok/bin` to your `PATH` manually. Every transform is **idempotent**, so re-running is safe. See the tables below for a full list of differences between the Notion export and what OpenKnowledge supports. **Options:** | Flag | Effect | | --------------------------------- | ---------------------------------------------------------------------------------------- | | `--apply` | Write the changes (default is a dry-run preview). | | `--strip-base64` | Delete inline base64 images instead of extracting them to files. | | `--remove-csv` | Delete each `_all.csv` once its table page exists (destructive). | | `--only ` / `--skip ` | Run or skip specific transforms: `links`, `frontmatter`, `callouts`, `images`, `tables`. | | `--force` | Run even if the folder isn't detected as a Notion export. | | `--json` | Print a machine-readable report. | > **Info** > > The command refuses to touch a folder that doesn't look like a Notion export unless you pass `--force`. ## Open the export in OpenKnowledge ### Desktop app Open OpenKnowledge, choose **Open folder on disk**, select the unzipped export folder, and proceed through the **Setup** screen with defaults selected. ### Web app `cd` into the unzipped folder and run `ok init && ok start`. ## What exports cleanly | Notion content | In OpenKnowledge | | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Headings, paragraphs, bold / italic, quotes, and dividers | Render natively and are preserved in the exported markdown. | | Bulleted, numbered, and to-do lists | Render natively, including nesting and `- [ ]` checkboxes. | | Code blocks | Render with syntax highlighting. | | Simple (inline) tables | Convert to Markdown pipe tables and render as tables. | | Images and file attachments | Downloaded into the export folder next to each page and referenced with relative `![alt](path)` links; images render inline. See [Assets and embeds](https://openknowledge.ai/docs/features/assets-and-embeds). | ## Where the two differ A number of Notion features don't survive the Markdown & CSV export, or land as plain text. Many can be fixed by the [`ok migrate notion `](https://openknowledge.ai/docs/migrate/notion#clean-up-the-export-with-ok-migrate-notion) command. | Notion feature | Exported result | Fixed by CLI migration command | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | **Databases** (tables, boards, calendars, galleries, timelines) | Each database exports as a `_all.csv` file and a folder holding one markdown file per row. Full-page databases also get a stub page. | ✅ Creates a Markdown table page for every CSV. The `.csv` files are not deleted unless you pass `--remove-csv`. | | **Database row properties** | Exported as plain `Key: Value` lines under the page title, not YAML frontmatter. | ✅ Lifted into YAML frontmatter so they show in the [Properties panel](https://openknowledge.ai/docs/features/editor#properties). | | **Callouts** | Exported as raw `