https://github.com/cobertos/notion_export_enhancer

Export and _enhance_, takes Notion's export and makes it just a bit more usable
https://github.com/cobertos/notion_export_enhancer

Last synced: 2 months ago
JSON representation

Export and _enhance_, takes Notion's export and makes it just a bit more usable

• Host: GitHub
• URL: https://github.com/cobertos/notion_export_enhancer
• Owner: Cobertos
• License: mit
• Created: 2020-12-29T05:46:51.000Z (about 4 years ago)
• Default Branch: owo
• Last Pushed: 2021-12-16T12:33:27.000Z (about 3 years ago)
• Last Synced: 2024-10-31T17:38:50.148Z (2 months ago)
• Language: Python
• Size: 319 KB
• Stars: 26
• Watchers: 3
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


    

    

    

    



# Notion Export Enhancer

Takes a [Notion.so](https://notion.so) export .zip and enhances it by:

* Removing all Notion IDs from the end of folders and files

* Adds Unicode Emoji to start of folder/file names if it was in your Notion notes

* Retruncates note titles to 200 characters instead of 50

* Applies Notion's modification time to the file data itself

* Moves root md files into the folder with their name, giving them a name like `!index.md` instead so they sort to the top.



    



TODO:

* Remove empty notes (ones with only links)?

* Rewrite csv + md tables into md tables where appropriate?

* .exe instead of .py?

* Image captions should become MD alt image text, not a separate paragraph

  * Would require exporting everything ourselves, paragraph after image is ambiguous

Supports Python 3.6+

## Usage from CLI

* Export your notion workspace

  * You can export a single workspace from `Settings > [Workspace] Settings > Export Content > Export all workspace content`



    



  * Choose export option `"Markdown & CSV"`

* `pip install notion_export_enhancer`

* Then run like `python -m notion_export_enhancer [token_v2] [path_to_zip]`

  * `token_v2` is your Notion.so token, which can be obtained by inspecting your browser cookies on a logged-in (non-guest) session on Notion.so

There are also some configuration options:

* `--output-path`: Optionally set an output path, otherwise uses the current working directory

* `--remove-title`: Removes the title that Notion adds. H1s at the top of every file (default false)

* `--rewrite-paths`: Rewrite the paths in the Markdown files themselves to match file renaming (default true)

## Contributing

See [CONTRIBUTING.md](https://github.com/Cobertos/notion_export_enhancer/blob/master/CONTRIBUTING.md)