Moving to Docusaurus 🦖

Why I moved to Docusaurus and what to expect

Even though the blog hasn't been running for very long and I think Astro Cactus is very cool, I decided to switch to Docusaurus as the platform.

I really like the base project because it is already very polished and easy to set up and customise.

All you need is Node.js version 18 or higher and the following command to get started (see official docs)

npx create-docusaurus@latest <my-website> classic

It supports both Markdown and MDX, so you can fully embed your own React components.

Docusaurus supports a similar feature set, there is a blog component, a documentation component and custom pages.

Although Docusaurus is mainly used for technical documentation, the blog component can be used as an entry point to the site. I use the Docs component for notes and technical things that I can look up again and again.

A local search (easyops-cn/docusaurus-search-local) also makes it easy to find content as it grows.

Even though Docusaurus supports MDX and Markdown, I have not yet found an ideal way to deal with the different flavours of Markdown. I'm also still experimenting with the design, but otherwise I'm very happy with the move and hope to publish a lot more content in the coming months.