{"id":13658576,"url":"https://github.com/echo724/notion2md","last_synced_at":"2025-05-15T11:06:07.056Z","repository":{"id":39996034,"uuid":"275703871","full_name":"echo724/notion2md","owner":"echo724","description":"Notion Markdown Exporter with Python Cli","archived":false,"fork":false,"pushed_at":"2024-01-10T11:15:45.000Z","size":7121,"stargazers_count":709,"open_issues_count":6,"forks_count":59,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-14T19:57:09.037Z","etag":null,"topics":["markdown","notion","notion-markdown"],"latest_commit_sha":null,"homepage":"","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/echo724.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"echo724"}},"created_at":"2020-06-29T01:43:38.000Z","updated_at":"2025-04-14T08:38:21.000Z","dependencies_parsed_at":"2024-01-12T13:49:10.273Z","dependency_job_id":"bb9797a7-910e-4b4c-8af4-8e4879ac2cf0","html_url":"https://github.com/echo724/notion2md","commit_stats":{"total_commits":329,"total_committers":15,"mean_commits":"21.933333333333334","dds":"0.35258358662613987","last_synced_commit":"180200051de9659b00b56499b1d6f3918e5d650f"},"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echo724%2Fnotion2md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echo724%2Fnotion2md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echo724%2Fnotion2md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/echo724%2Fnotion2md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/echo724","download_url":"https://codeload.github.com/echo724/notion2md/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328385,"owners_count":22052632,"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":["markdown","notion","notion-markdown"],"created_at":"2024-08-02T05:01:00.833Z","updated_at":"2025-05-15T11:06:07.010Z","avatar_url":"https://github.com/echo724.png","language":"Python","funding_links":["https://github.com/sponsors/echo724","https://www.buymeacoffee.com/echo724"],"categories":["Python","HarmonyOS","APIs"],"sub_categories":["Windows Manager"],"readme":"![Notion2Md logo - an arrow pointing from \"N\" to \"MD\"](Notion2md.jpg)\n\n\u003cbr/\u003e\n\n## About Notion2Md\n\n[![Downloads](https://static.pepy.tech/badge/notion2md)](https://pepy.tech/project/notion2md)\n[![PyPI version](https://badge.fury.io/py/notion2md.svg)](https://badge.fury.io/py/notion2md)\n[![Code Quality](https://github.com/echo724/notion2md/actions/workflows/code_quality.yaml/badge.svg)](https://github.com/echo724/notion2md/actions/workflows/code_quality.yaml)\n\u003ca href=\"https://hits.seeyoufarm.com\"\u003e\u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fecho724%2Fnotion2md\u0026count_bg=%23949191\u0026title_bg=%23555555\u0026icon=github.svg\u0026icon_color=%23E7E7E7\u0026title=visited\u0026edge_flat=false\"/\u003e\u003c/a\u003e\n\n- Notion Markdown Exporter using **official notion api** by [notion-sdk-py](https://github.com/ramnes/notion-sdk-py)\n\n### Notion2Medium\n\n- Check out [Notion2Medium](https://github.com/echo724/notion2medium) that publishes a **Medium** post from **Notion** using Notion2Md.\n\n## API Key(Token)\n\n- Before getting started, create [an integration and find the token](https://www.notion.so/my-integrations). → [Learn more about authorization](https://developers.notion.com/docs/authorization).\n\n- Then save your api key(token) as your os environment variable\n\n- From version 2.9.0, you can use `--token` or `-t` option to set your token key.\n\n```Bash\n$ export NOTION_TOKEN=\"{your integration token key}\"\n```\n\n## Install\n\n```Bash\n$ pip install notion2md\n```\n\n## Usage: Shell Command\n\n![Terminal output of the `notion2md -h` command](notion2md_options.png)\n\n- Notion2md requires either `id` or `url` of the Notion page/block.\n\n- **download** option will download files/images in the `path` directory.\n\n- **unzipped** option makes Notion2Md export ***unzipped*** output of Notion block.\n\n```Bash\nnotion2md --download -n post -p ~/MyBlog/content/posts -u https://notion.so/...\n```\n\n- This command will generate \"**post.zip**\" in your '**~/MyBlog/content/posts**' directory.\n\n## Usage: Python\n\n```Python\nfrom notion2md.exporter.block import MarkdownExporter, StringExporter\n\n# MarkdownExporter will make markdown file on your output path\nMarkdownExporter(block_id='...',output_path='...',download=True).export()\n\n# StringExporter will return output as String type\nmd = StringExporter(block_id='...',output_path='...').export()\n```\n\n## To-do\n\n- [x] Download file object(image and files)\n- [x] Table blocks\n- [x] Synced Block\n- [ ] Page Exporter\n- [ ] Child page\n- [ ] Column List and Column Blocks\n\n## Contribution\n\nPlease read [Contribution Guide](CONTRIBUTION.md)\n\n## Donation\n\nIf you think **Notion2Md** is helpful to you, you can support me here:\n\n\u003ca href=\"https://www.buymeacoffee.com/echo724\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 54px;\" height=\"54\"\u003e\u003c/a\u003e\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecho724%2Fnotion2md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fecho724%2Fnotion2md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fecho724%2Fnotion2md/lists"}