{"id":20626325,"url":"https://github.com/tryfabric/markdown-to-notion","last_synced_at":"2025-04-15T15:20:26.106Z","repository":{"id":95842852,"uuid":"483346458","full_name":"tryfabric/markdown-to-notion","owner":"tryfabric","description":"A GitHub Action that lets you upload a Markdown file to a Notion page ","archived":false,"fork":false,"pushed_at":"2022-05-05T16:43:46.000Z","size":359,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T21:42:47.734Z","etag":null,"topics":["actions","github","github-actions","markdown","notion","notion-api","notion-blocks"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/tryfabric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-19T17:34:36.000Z","updated_at":"2025-03-02T03:50:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"40add781-dd0b-48f7-b894-6210319c8a17","html_url":"https://github.com/tryfabric/markdown-to-notion","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fmarkdown-to-notion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fmarkdown-to-notion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fmarkdown-to-notion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fmarkdown-to-notion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tryfabric","download_url":"https://codeload.github.com/tryfabric/markdown-to-notion/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249094939,"owners_count":21211837,"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":["actions","github","github-actions","markdown","notion","notion-api","notion-blocks"],"created_at":"2024-11-16T13:12:43.039Z","updated_at":"2025-04-15T15:20:26.099Z","avatar_url":"https://github.com/tryfabric.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown to Notion\n\nLoad a Markdown file into Notion with GitHub Actions.\n\n## How does it work?\n\nThis action will read your Markdown file and convert it to Notion blocks using [`martian`](https://github.com/instantish/martian).  \nIt will then append a synced block to your page containing the result of the conversion.  \nBy default, the action will delete the first synced block it'll find in the page: this way it's able to quickly update your page without causing duplicates. Please keep in mind that you're not supposed to add other blocks to the page, otherwise the action may not work properly.\n\n## Inputs\n\n```yaml\n- uses: tryfabric/markdown-to-notion@v1\n  with:\n    # The local path of the Markdown file to load.\n    file: ./your/file.md\n\n    # The token to use to access the Notion API. See the \"How do I get a token?\" FAQ for more info.\n    notion_token: ${{ secrets.YOUR_INTEGRATION_TOKEN }}\n\n    # The ID of the page you want the file loaded into. See the \"How do I find the page ID?\" FAQ for more info.\n    notion_id: YourPageID\n\n    # Whether to delete the existing block.\n    # Default: true\n    delete_existing: false\n```\n\n## Outputs\n\nThe action provides these outputs:\n\n- `block_id`: the ID of the new block that has been appended.\n\nFor more info on how to use outputs, see the [`steps` context docs](https://docs.github.com/en/actions/learn-github-actions/contexts#steps-context).\n\n## FAQs\n\n### How do I get a token?\n\n[Create a new intergration](https://www.notion.so/my-integrations) and save its token to a [new repository secret](https://docs.github.com/en/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository).  \nShare your page with your integration and update your workflow to use the secret.\n\n### How do I find the page ID?\n\nGo to your page in Notion, then look at the URL. Notion URLs are formatted like this:\n\n```none\nhttps://notion.so/\u003cTITLE\u003e-\u003cPAGEID\u003e\nhttps://notion.so/\u003cTITLE\u003e-\u003cPAGEID\u003e#\u003cBLOCKID\u003e\n```\n\nBoth `\u003cPAGEID\u003e` and `\u003cBLOCKID\u003e` (when present) are dash-less UUIDv4 strings, here's an example: `17e70ad9dc1941adbd2d19155fc4ac8f`.  \nTo get the page ID, simply copy the first ID in the URL.\n\n```none\nhttps://notion.so/title-01ff8594fa8a4fb192cf017f8fdbf8d4\n-\u003e ID: 01ff8594fa8a4fb192cf017f8fdbf8d4\n\nhttps://notion.so/othertitle-d673994443b34640a1768ac23cc202e2#49fc54c8af564f8cb052ce34fb590809\n-\u003e ID: d673994443b34640a1768ac23cc202e2\n```\n\n---\n\nBuild with :blue_heart: by the team behind [Fabric](https://tryfabric.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryfabric%2Fmarkdown-to-notion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftryfabric%2Fmarkdown-to-notion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryfabric%2Fmarkdown-to-notion/lists"}