Docusaurus site with Notion

Publishing a Docusaurus site written in Notion with Docu-Notion

December 11, 2023

Notion has a great UI for publishing documentation articles in Markdown. You don’t need to know code, although it helps to be a bit geeky.

The challenge is that Notion does not publish a useful Documentation website based on those pages. The template is super-basic with zero features, like no built-in search, no left nav, etc. You get a page list and cookie crumb linking, but for a rich documentation site with a lot of pages, that is a poor user experience.

The next goal is seeing how to publish those documents on the web, with the nice three column layout seen in popular static-site-generator (SSG) websites like Docusaurus. While there is the paid service by Notaku that does this as a ‘no-code’ solution, I wanted to see if there was some code that we could use to do this and not have to pay for Notaku, which is a little steep monthly ($30 - $50 with page and bandwidth limits) for what we need.

Today I found a Github repo called Docu-notion that seems to do exactly that:

• Takes Notion content (via API integration)
• Publishes that content into Docusaurus

Here is how it works.

The Docu-Notion template code (Here on Github) will take content pages authored and published in Notion, and put them into a Docusaurus site.

The author of Docu-notion has a sample site here, shown in the screenshot below.

Example page from Docu-notion sample site