Getting Started

Migrate From GitBook or mkdocs in One Command

The single biggest thing standing between a team and switching docs tools is almost never the tool itself - it's the migration. Nobody wants to hand-convert three hundred Markdown files and their nav structure. bxSites migrate exists specifically to remove that excuse, for the two sources I hear about most: GitBook and mkdocs.

Read more →


Pick Your Theme

Update: this post originally covered the three themes BxSites launched with. The lineup has since grown into a full ten-theme gallery - the table and advice below now cover all ten.

One question I get a lot after someone runs bxSites new for the first time: "which theme should I actually pick?" The honest answer is that it barely matters at the feature level - all ten built-in themes ship the exact same set of capabilities. It's purely a question of which one matches your project's own visual identity.

Read more →


Get Your Docs Live in 10 Minutes

I've written a lot of documentation tools over the years, and the thing I keep coming back to with BxSites is how little ceremony is involved in going from nothing to a real, browsable static site. No config wizard, no plugin marketplace to shop through first - just a folder of Markdown and one command.

Read more →