{"id":17114580,"url":"https://github.com/cobertos/notion_export_enhancer","last_synced_at":"2025-04-13T02:32:46.621Z","repository":{"id":37389002,"uuid":"325197766","full_name":"Cobertos/notion_export_enhancer","owner":"Cobertos","description":"Export and _enhance_, takes Notion's export and makes it just a bit more usable","archived":false,"fork":false,"pushed_at":"2021-12-16T12:33:27.000Z","size":327,"stargazers_count":27,"open_issues_count":3,"forks_count":5,"subscribers_count":2,"default_branch":"owo","last_synced_at":"2025-04-10T19:53:28.439Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cobertos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-29T05:46:51.000Z","updated_at":"2025-03-04T20:36:43.000Z","dependencies_parsed_at":"2022-09-05T09:31:36.930Z","dependency_job_id":null,"html_url":"https://github.com/Cobertos/notion_export_enhancer","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cobertos%2Fnotion_export_enhancer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cobertos%2Fnotion_export_enhancer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cobertos%2Fnotion_export_enhancer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cobertos%2Fnotion_export_enhancer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cobertos","download_url":"https://codeload.github.com/Cobertos/notion_export_enhancer/tar.gz/refs/heads/owo","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657824,"owners_count":21140842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T17:19:21.912Z","updated_at":"2025-04-13T02:32:46.231Z","avatar_url":"https://github.com/Cobertos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/Cobertos/notion_export_enhancer/actions\" target=\"_blank\"\u003e\u003cimg alt=\"build status\" src=\"https://github.com/Cobertos/notion_export_enhancer/workflows/Package%20Tests/badge.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://pypi.org/project/notion_export_enhancer/\" target=\"_blank\"\u003e\u003cimg alt=\"pypi python versions\" src=\"https://img.shields.io/pypi/pyversions/notion_export_enhancer.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/cobertos\" target=\"_blank\"\u003e\u003cimg alt=\"twitter\" src=\"https://img.shields.io/badge/twitter-%40cobertos-0084b4.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://cobertos.com\" target=\"_blank\"\u003e\u003cimg alt=\"twitter\" src=\"https://img.shields.io/badge/website-cobertos.com-888888.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Notion Export Enhancer\n\nTakes a [Notion.so](https://notion.so) export .zip and enhances it by:\n\n* Removing all Notion IDs from the end of folders and files\n* Adds Unicode Emoji to start of folder/file names if it was in your Notion notes\n* Retruncates note titles to 200 characters instead of 50\n* Applies Notion's modification time to the file data itself\n* Moves root md files into the folder with their name, giving them a name like `!index.md` instead so they sort to the top.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"folders with emojis\" src=\"https://raw.githubusercontent.com/Cobertos/notion_export_enhancer/owo/media/folders.png\"\u003e\n\u003c/p\u003e\n\nTODO:\n* Remove empty notes (ones with only links)?\n* Rewrite csv + md tables into md tables where appropriate?\n* .exe instead of .py?\n* Image captions should become MD alt image text, not a separate paragraph\n  * Would require exporting everything ourselves, paragraph after image is ambiguous\n\nSupports Python 3.6+\n\n## Usage from CLI\n\n* Export your notion workspace\n  * You can export a single workspace from `Settings \u003e [Workspace] Settings \u003e Export Content \u003e Export all workspace content`\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"Notion export menu for where to export workspace\" src=\"https://raw.githubusercontent.com/Cobertos/notion_export_enhancer/owo/media/where-to-export.png\"\u003e\n\u003c/p\u003e\n\n  * Choose export option `\"Markdown \u0026 CSV\"`\n* `pip install notion_export_enhancer`\n* Then run like `python -m notion_export_enhancer [token_v2] [path_to_zip]`\n  * `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\n\nThere are also some configuration options:\n\n* `--output-path`: Optionally set an output path, otherwise uses the current working directory\n* `--remove-title`: Removes the title that Notion adds. H1s at the top of every file (default false)\n* `--rewrite-paths`: Rewrite the paths in the Markdown files themselves to match file renaming (default true)\n\n## Contributing\nSee [CONTRIBUTING.md](https://github.com/Cobertos/notion_export_enhancer/blob/master/CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobertos%2Fnotion_export_enhancer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcobertos%2Fnotion_export_enhancer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcobertos%2Fnotion_export_enhancer/lists"}