4 pontos por GN⁺ 2023-07-01 | 1 comentários | Compartilhar no WhatsApp
  • O MdBook é uma ferramenta de linha de comando que permite criar livros usando Markdown.
  • É excelente para criar documentação de produtos ou APIs, tutoriais e materiais de aula.
  • O MdBook tem uma sintaxe Markdown leve, permitindo que você se concentre no conteúdo.
  • Também oferece suporte a busca integrada e destaque de sintaxe com cores para blocos de código em várias linguagens.
  • É possível personalizar o formato de saída usando arquivos de tema.
  • Com preprocessadores, é possível adicionar sintaxe personalizada e modificar o conteúdo.
  • O MdBook foi escrito em Rust, sendo rápido, seguro e simples.
  • Há testes automatizados para exemplos de código Rust.
  • O MdBook é usado no projeto da linguagem de programação Rust e no livro The Rust Programming Language.
  • O MdBook é gratuito e de código aberto, e você pode contribuir com o desenvolvimento no GitHub.
  • O código-fonte e a documentação do mdBook são distribuídos sob a Mozilla Public License v2.0.

1 comentários

 
GN⁺ 2023-07-01
Comentários no Hacker News
  • O uso de bibliotecas hospedadas em CDN expõe os usuários do MdBook a possíveis quedas de servidor e coleta de dados.
  • A combinação de Highlight.js e MathJax é ineficiente e desperdiça recursos no frontend do MdBook.
  • MdBook é uma ferramenta de linha de comando para criar livros com Markdown.
  • Outras ferramentas semelhantes mencionadas nos comentários incluem Jekyll, MkDocs, Hugo e Antora.
  • Alguns usuários acham o MdBook minimalista demais e o expandiram com código Rust personalizado.
  • O Gitbook já foi popular, mas ficou lento e alguns recursos específicos foram descontinuados.
  • Alguns usuários preferem o MkDocs ao MdBook por ter recursos embutidos, como sumário à direita.
  • O MdBook é elogiado pela simplicidade e velocidade na geração de pequenas páginas estáticas.
  • KeenWrite é mencionado como outra ferramenta para criar livros baseados em Markdown usando ConTeXt.
  • Alguns usuários expressam insatisfação com o Markdown e procuram alternativas para escrever documentação técnica.
  • O Markdown é elogiado pela concisão, e há quem questione por que ele não é usado como formato padrão para livros e documentação.