Table of Contents

Are you curious on June 25, 2024 whether to use Notion Sites v2 or Webtrotion? Check this out! If you are checking it out November 1, 2025, then Webtrotion 2.0 also supports footnotes and citations (special parsing), which Notion Sites cannot render.

Just take me to the github link:

GitHub - nerdymomocat-templates/webtrotion-astro-notion-cms-website-blog: Your own notion website with astro

Support me on product hunt!

(Pssst... check out how this looks hosted through Webtrotion!)

<!DOCTYPE html>
<!-- inject -->
<a
  href="<https://www.producthunt.com/posts/webtrotion?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-webtrotion>"
  target="_blank"
  ><img
    src="<https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=469215&theme=neutral>"
    alt="Webtrotion - Notion&#0045;based&#0032;configurable&#0032;static&#0032;website&#0032;generator | Product Hunt"
    style="width: 250px; height: 54px;"
    width="250"
    height="54"
/></a>

New Features and Changelog

Webtrotion is a extensively configurable, simple to install website builder, built with the Astro framework in conjunction with Notion. Use it to create an easy-to-use blog or website.

(Skip to features and setup)

Acknowledgements

This theme is built based off three major contributions:

Astro Cactus
notion-astro-blog
And this person on fiverr who got me 80% there on how to integrate notion into cactus theme
Claude code and gemini cli [^ft_ccgemcli]

[^ft_ccgemcli]: From September 2025 onwards, AI assistants have been used to develop complete features. Before this, GitHub Copilot and chat-based AI tools assisted with code writing but not full feature development.

Webtrotion Cat

Why Webtrotion

Webtrotion was built with the simple idea - most notion based builders, require at least one of these four things:

A custom domain, or being willing to use a vercel like domain
Just have blogposts be editable in Notion while pages are edited in the repo
Require some third party tools, or are not free to use.
Are not configurable because they are either based off third parties like super.so or the configuring requires editing multiple code files.

And I did not want that. We want something that converts well into a static site, can be hosted on github for free using the github.io domain, and can have both pages and blog posts and be configured pretty easily.

Why Notion and Astro

I use Notion for all my notes, and it did not make sense for me to download them into an md file, carefully figure out the logistics and push/pull with other SSGs like Quartro, Eleventy, Hugo or Jekyll.
I could have used another CMS but again, I use Notion, and it is easier to keep the content in one place. Notion also comes with interesting affordances that other CMS don’t: WYSIWYG for various components, block level permissions (to add drafts to post text), easy collaboration etc.
There are some NextJS options that kinda fulfill this criteria but I do not know NextJS and I did not want to figure it out at the moment, for example: Notion Next, Morethan-log, and Notion-Blog-NextJs