Docusaurus, para transformar documentos em sites


Chegou ao mundo o Docusaurus 2.0, a nova versão da ferramenta para desenvolvimento e criação de sites a partir de documentação, um projeto open source com mais de 35k estrelas do GitHub, gratuito com licença MIT, pronto para ajudar a criar sites em cinco minutos.

É um construtor de sites estático, completamente focado em conteúdo (documentos, blog, páginas, controle de versão, SEO e muito mais). Nos permite concentrar no conteúdo, e deixar a publicação na Internet para o final, sendo apenas necessário escrever arquivos Markdown.

Docusaurus é muito flexível (possui plugins e temas), o que possibilita a criação de sites com estética única.

Utiliza MDX, permite usar React dentro de arquivos Markdown, oferecendo, assim, interatividade nos documentos.

Nasceu do Meta (Facebook) como um de seus projetos internos. O objetivo era economizar tempo ao criar um novo site de documentação, então, criaram o Docusaurus em 2017. Agora nasce sua segunda versão, após uma fase alfa/beta de quatro anos.

Eles já têm quase 300 sites publicados com esta v2, e aparentemente será usada por empresas como LinkedIn, Microsoft, Shopify, SAP e muitas outras. São sites que suportam versionamento de documentos, ajudando a manter a documentação em sincronia com as versões do projeto.

É importante deixar claro que o Docusaurus ainda é uma ferramenta de desenvolvimento que requer conhecimentos básicos de Node.js, e também é preciso conhecer o React para customizar o site. Os arquivos Markdown geralmente são armazenados no Git e, no futuro, pensam em trabalhar em integrações de CMS.

Confira abaixo um pouco do que é capaz:

Link: docusaurus.io.