https://github.com/sueszli/notionbackup

prettify notion html exports
https://github.com/sueszli/notionbackup

data-preservation notion notion-html unminified

Last synced: 5 days ago
JSON representation

prettify notion html exports

• Host: GitHub
• URL: https://github.com/sueszli/notionbackup
• Owner: sueszli
• License: agpl-3.0
• Created: 2023-06-20T08:32:48.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-30T20:30:44.000Z (about 1 month ago)
• Last Synced: 2024-10-29T21:04:20.194Z (7 days ago)
• Topics: data-preservation, notion, notion-html, unminified
• Language: Makefile
• Homepage:
• Size: 40.2 MB
• Stars: 52
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
```

    _   __      __  _                ____             __

   / | / /___  / /_(_)___  ____     / __ )____ ______/ /____  ______

  /  |/ / __ \/ __/ / __ \/ __ \   / __  / __ `/ ___/ //_/ / / / __ \

 / /|  / /_/ / /_/ / /_/ / / / /  / /_/ / /_/ / /__/ ,< / /_/ / /_/ /

/_/ |_/\____/\__/_/\____/_/ /_/  /_____/\__,_/\___/_/|_|\__,_/ .___/

                                                            /_/

future-proof your notion exports

```

notion's default html exports are the only way to get a lossless backup of your data. however, they are not editable, require an internet connection and are styled very differently from the notion web app.

this script fixes all of that by converting your html exports into an (1) editable, (2) fully offline and (3) notion-styled format.

    learn more!  

| export type           | no data loss      | fully offline                  | editable      |

| --------------------- | ----------------- | ------------------------------ | ------------- |

| notion API (json)     | ❌                | ✅                             | ✅            |

| web scraping (html)   | ❌ (unreliable)   | ❌ (depends on implementation) | ❌ (minified) |

| pdf                   | ❌                | ✅                             | ❌            |

| markdown              | ❌                | ✅                             | ✅            |

| html                  | ✅                | ❌ (CDN dependency)            | ❌ (minified) |

| _html + notionBackup_ | ✅                | ✅                             | ✅            |

we can differentiate between two types of exports:

*a) non-html exports:* everything that isn't html is inherently lossy. this is because json, markdown and pdf can't express everything that html can (like toggles, nested blocks, etc).

*b) html exports:* html exports are lossless but not editable (minified), require an internet connection (javascript CDN dependency for KaTeX) and are styled very differently from the notion web app.




# usage

when exporting from notion, remember to select "html" as the export format, enable the "everything" option, "include subpages" and also "create folders for subpages".

```bash

git clone https://github.com/sueszli/notionBackup

cd notionBackup

pip install -r requirements.txt

# demo

python notionbackup ./data/all-blocks.zip

python notionbackup ./data/blog.zip

python notionbackup ./data/full-templates.zip

```