Skip to content
Notis

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.

TriggerScheduled

Add multiple content blocks (bulk, user-friendly)

Adds multiple content blocks to a Notion page or supported block; simplified text may be truncated.

ActionInstant

Webhook trigger

Notis starts this workflow when an external tool or custom backend sends an HTTP request.

TriggerInstant

Add single content block to Notion page (Deprecated)

Deprecated: Adds content to a Notion page or block; requires access and permission to insert content.

ActionInstant

New Workflow Artifact Created

Fires when a new GitHub Actions workflow artifact is created in a repository.

TriggerPolling

Append raw Notion blocks (advanced API)

Deprecated: Appends raw blocks to a Notion page or block.

ActionInstant

Branch Changed

Fires when a branch’s commits or protection status or settings change.

TriggerPolling

Archive Notion Page

Archives a page to the trash or restores it; workspace-level pages must be archived in the interface.

ActionInstant

New Branch Created

Fires when a new branch is created in a GitHub repository.

TriggerPolling

Append code blocks (code, quote, equation)

Appends code, quote, or equation blocks; each code text field is limited to 2,000 characters.

ActionInstant

Check Run Status / Conclusion Changed

Fires when a GitHub check run’s status or conclusion changes.

TriggerPolling

Create comment

Adds a comment to a page or an existing discussion thread.

ActionInstant

Check Suite Status / Conclusion Changed

Fires when a GitHub check suite changes status or conclusion for a reference.

TriggerPolling

Append layout blocks (divider, TOC, columns)

Appends layout blocks, including dividers, tables of contents, breadcrumbs, or columns.

ActionInstant

New Code Scanning Alert Created

Fires when a new code scanning alert is created in a repository.

TriggerPolling

Create Notion Database

Creates a database as a subpage of a specified parent page.

ActionInstant

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.