Keep Your Documentation in Sync Automatically
Every time your GitHub README is updated, Notion is notified and the documentation is refreshed, ensuring your team's knowledge base stays current.
Trigger
GitHub Repository README Changed
Fires when the README file in a GitHub repository directory changes.
Action
Add multiple content blocks (bulk, user-friendly)
Adds multiple content blocks to a Notion page or supported block; simplified text may be truncated.
Why this helps
README updates happen in GitHub but your Notion project documentation becomes stale, creating confusion about current project status and setup.
- Documentation stays current across GitHub and Notion
- Centralize project information in your workspace
- Reduce documentation maintenance overhead
- Single source of truth for project setup and status
Setup
Build it in a few focused steps.
- 1Connect GitHub and Notion via Notis.
- 2Tell Notis: 'When the README changes, update the corresponding Notion documentation page with the new content.'
- 3Select the 'Repository README Changed' trigger and your notification channel.
- 4Update your GitHub README and verify the Notion page updates automatically.
Questions about this workflow
Does this create a new Notion page if one doesn't exist?
Yes. Notis can create a documentation page on first sync, then keep it updated on subsequent changes.
Will Notion formatting match the GitHub README?
Notis parses markdown and converts it to Notion formatting automatically, maintaining headers, bold, lists, and links.
When this happens · Trigger
Fires when the README file in a GitHub repository directory changes.
Do this · Action
Adds multiple content blocks to a Notion page or supported block; simplified text may be truncated.
Supported Triggers and Actions
Notis builds workflows that link GitHub to Notion. A trigger fires from one place; an action lands in another.
GitHub triggers
Notion actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
Add multiple content blocks (bulk, user-friendly)
Adds multiple content blocks to a Notion page or supported block; simplified text may be truncated.
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Add single content block to Notion page (Deprecated)
Deprecated: Adds content to a Notion page or block; requires access and permission to insert content.
New Workflow Artifact Created
Fires when a new GitHub Actions workflow artifact is created in a repository.
Append raw Notion blocks (advanced API)
Deprecated: Appends raw blocks to a Notion page or block.
Branch Changed
Fires when a branch’s commits or protection status or settings change.
Archive Notion Page
Archives a page to the trash or restores it; workspace-level pages must be archived in the interface.
New Branch Created
Fires when a new branch is created in a GitHub repository.
Append code blocks (code, quote, equation)
Appends code, quote, or equation blocks; each code text field is limited to 2,000 characters.
Check Run Status / Conclusion Changed
Fires when a GitHub check run’s status or conclusion changes.
Create comment
Adds a comment to a page or an existing discussion thread.
Check Suite Status / Conclusion Changed
Fires when a GitHub check suite changes status or conclusion for a reference.
Append layout blocks (divider, TOC, columns)
Appends layout blocks, including dividers, tables of contents, breadcrumbs, or columns.
New Code Scanning Alert Created
Fires when a new code scanning alert is created in a repository.
Create Notion Database
Creates a database as a subpage of a specified parent page.
Connect any two apps with Notis in the middle.
GitHub and Notion, or any other combination from 1,700+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with $20 of usage included.
No card. Works with personal or business Notion.