Notation

Notation is a tool that lets users author documentation in Markdown and publish it to Notion pages or public websites. It is designed for developers and teams who want docs to live with code and be searchable within their workspace. The approach avoids separate online documentation tools and integrates with existing Notion workflows.

Notation operates by placing a Notation.toml configuration next to the binary, including a secret for Notion and a parent page name, then running a ship command to publish. The process begins with creating a Notion integration, configuring the TOML file, and shipping content from Markdown into Notion.

Documentation published through Notation can either stay internal inside a Notion workspace or be surfaced as a public website. The product includes access to Notion’s AI, search, and formatting by default, enabling enhanced organization and retrieval of docs within the Notion environment.

Notation provides deployment options that include keeping content internal to a workspace, shipping as a Notion page, or deploying as a full website with partners like super.so. It also supports simple features like intro.md for direct content on parent pages and CLI-based page customization via title and emoji parameters.

Use cases

• Publish developer docs for internal teams