Notion naar Markdown: databases als losse CSV-bestanden

Je kunt een volledige Notion-workspace exporteren als Markdown & CSV. De exporthandleiding van Notion beschrijft het resultaat: gewone pagina’s worden Markdown-bestanden, volledige paginadabases worden afzonderlijke CSV-bestanden en hun subpagina’s worden losse Markdown-bestanden. Callouts worden als HTML geëxporteerd. Je ontvangt een ZIP-archief dat je eerst moet uitpakken.

Ook een enkele eenvoudige pagina kan als ZIP-bestand worden geleverd: een melding van een Notion-gebruiker beschrijft dit bij een pagina zonder subpagina’s of bijlagen. Voor een migratie telt wat er na het uitpakken staat en of de pagina’s, databasegegevens, links en bestanden samen bruikbaar zijn.

Maak een proefpagina met de onderdelen die je wilt behouden

Maak vóór de volledige export een kleine pagina waarvan je de inhoud goed kent. Voeg tekst met een kop, een callout, een link naar een andere Notion-pagina en een afbeelding of bijlage toe. Maak daarnaast een volledige paginadatabase met een herkenbaar item en schrijf ook iets in de pagina van dat item. Zo kun je na het uitpakken nagaan of zowel de tabelgegevens als de inhoud van de itempagina aanwezig zijn.

Noteer waar de interne link naartoe leidt en welke bijlage bij welke pagina hoort. Als de database relaties, formules, rollups of specifieke weergaven gebruikt, leg dan vast welke uitkomst of ordening voor jou belangrijk is. Een CSV kan de rijen tonen, maar daarmee staat nog niet vast dat de nieuwe omgeving dezelfde databasefuncties kan uitvoeren. Herkenbare namen helpen je de onderdelen in een grote export terug te vinden.

Exporteer de volledige workspace

Open Notion op een computer in de desktopapp of browser. Ga via de zijbalk naar Instellingen, kies onder Workspace voor General en selecteer Alle workspace-content exporteren.
Kies Markdown & CSV als exportformaat en start de export.
Download het ZIP-archief via de link die je per e-mail ontvangt. Als e-mailmeldingen zijn uitgeschakeld, staat de link in de inbox van de app. Bewaar het origineel en pak een kopie uit voor de controle.

Een volledige workspace-export werkt via desktop of web. Pagina’s waartoe de exportfunctie geen toegang heeft, zoals privépagina’s van andere gebruikers, worden niet meegenomen. Ook instellingen van een teamspace kunnen de inhoud beperken. Spreek bij een gedeelde workspace vooraf af welke privépagina’s en teamspaces tot de migratie behoren. Laat eigenaren van ontbrekende privépagina’s die inhoud afzonderlijk exporteren of de benodigde toegang regelen.

Vergelijk de uitgepakte map met de proefpagina

Begin met de herkenbare proefpagina en open de bestanden zelf, in plaats van alleen de mappenlijst te bekijken. Controleer de tekst, de gekoppelde subpagina, de bijlage en de database-inhoud afzonderlijk. De grootte van het ZIP-bestand vertelt je niet of die onderdelen volledig en bruikbaar zijn.

Pagina’s en subpagina’s: zoek het Markdown-bestand van de proefpagina en open het als tekst. Kijk of koppen en alinea’s aanwezig zijn. Zoek de gelinkte pagina als eigen bestand en controleer of geneste pagina’s zijn meegenomen; een verwijzing naar een paginanaam is nog geen kopie van de inhoud.
Database: open het CSV-bestand in een programma dat CSV leest. Vergelijk kolomnamen en herkenbare rijen met de database in Notion. Zoek daarna het Markdown-bestand van de itempagina met tekst. De gegevens in een rij en de inhoud van die pagina staan in verschillende bestanden, dus loop beide na.
Callout: zoek de tekst terug in de geëxporteerde HTML en bekijk hoe het doelprogramma die weergeeft. Als de opmaak daar niet bruikbaar is, bewaar dan de tekst en bouw de callout opnieuw op. De opvallende vorm van een Notion-callout is geen standaardonderdeel van Markdown.
Interne link: open de geëxporteerde pagina lokaal en volg de verwijzing. Controleer of de doelpagina ook buiten Notion bereikbaar is. Leg kapotte links vast met hun oorspronkelijke doel, zodat je ze na het importeren aan de juiste nieuwe pagina kunt koppelen.
Afbeeldingen en bijlagen: zoek de afzonderlijke bestanden in de exportmap, open ze en volg de verwijzing vanuit de pagina. Test deze paden opnieuw nadat je de volledige map naar de beoogde opslagplek hebt gekopieerd: een werkende koppeling kan breken als je een bijlage later los verplaatst.

Vergelijk vervolgens enkele belangrijke pagina’s buiten de proefpagina met de bronworkspace. Neem ook een dieper geneste pagina en een database met verschillende soorten eigenschappen mee. Zo merk je of de proef een goed beeld geeft van de onderdelen waar je werk werkelijk van afhangt.

Herstel CSV-gegevens, opmaak en verwijzingen

Gebruik de CSV als overdraagbare tabelgegevens, niet als een werkende kopie van een Notion-database. Volgens de Notion-instructie voor CSV-import worden rijen bij een import pagina’s en kolommen eigenschappen, maar maakt een nieuwe CSV-import geen relaties, formules of rollups aan. Wil je zulke functies in de bestemming behouden, beschrijf dan per database welke eigenschappen verbonden waren en hoe berekende waarden ontstonden. Bouw die functies opnieuw op en vergelijk herkenbare items met het origineel.

Als de tekst van een callout wel aanwezig is maar de vorm niet, kies dan een gelijkwaardige opmaak in de nieuwe app. Voor pagina’s waarvan de oorspronkelijke presentatie belangrijk is, kun je daarnaast een afzonderlijke HTML-export bewaren. Herstel interne links pas wanneer de doelpagina’s hun definitieve plaats hebben; gebruik de genoteerde oorspronkelijke doelen om pagina’s met vergelijkbare namen uit elkaar te houden. Kopieer afbeeldingen en bijlagen samen met hun pagina’s, zodat bestandspaden niet door een losse verhuizing breken.

Verwijder de Notion-workspace pas wanneer de belangrijkste pagina’s, database-items, links en bijlagen in de bestemming geopend zijn en je benodigde databasefuncties hebt herbouwd. Bewaar het originele ZIP-archief zolang je nog verschillen onderzoekt. Daarmee kun je een gemist bestand terughalen en de oorspronkelijke indeling van de export raadplegen.