Docusaurus

Docusaurus is one of many Static Site Generators geared toward Documentation and Blogs. Docusaurus uses Markdown files to build a local html website.

Resources

• Installation
• Guides
• Code Sandbox
• Community Plugins

Features

• Supports MDX (to blend the JayaScript extension JSX with Markdown)
• Supports TypeScript (a programming language that adds extra functionality to JavaScript)
• Supports community plugins
• Built-in versioning (v1, v2, etc)
• Supports the Algolia search engine
• Supports internationalization (i18n)

My Thoughts

• Suitable for single-page documentation
• Easy to create new custom components to expand functionality
• Developer friendly, moderate learning curve for non-developers

Example Sites

• Docusaurus Documentation
• New Bucharest
• Semaphore

What I use it for

I’m currently working on a (documentation) website for a pen and paper game, see New Bucharest. The page contains customized content for creating character sheets, a custom image gallery, a random prompt generator.