Repolode
Enviar
rust-lang

rust-lang/mdBook

Una herramienta de línea de comandos escrita en Rust que genera libros en línea a partir de archivos Markdown, similar a GitBook.

Alternativa open source a:GitBook

Ver en GitHubSitio web
Estrellas
22,236
Forks
1,908
Issues abiertos
659
Último commit
hace 20 horas

¿Qué es?

mdBook convierte un directorio de archivos Markdown en un libro en línea moderno y fácil de navegar. Está pensado para documentación y contenido extenso, como guías de programación; la propia Guía del usuario del proyecto está hecha con él.

El proyecto está escrito en Rust y se distribuye a través de crates.io, por lo que se puede instalar como un único binario de línea de comandos. Los libros se describen mediante un archivo de configuración y una tabla de contenido, y el resultado es un sitio web estático que se puede alojar en cualquier servidor de archivos estáticos.

Como trabaja con archivos Markdown sin formato, el contenido permanece bajo control de versiones y se puede editar con cualquier editor de texto. La herramienta está publicada bajo la Mozilla Public License v2.0.

Funciones clave

  • 01Genera un libro HTML estático a partir de archivos Markdown.
  • 02La estructura del libro se define mediante un archivo de tabla de contenido.
  • 03Se puede instalar desde crates.io como un único binario de línea de comandos escrito en Rust.
  • 04El resultado es un sitio web estático que se puede alojar en cualquier servidor de archivos estáticos.

Casos de uso

  • Publicar la guía de usuario de un lenguaje de programación o una biblioteca.
  • Escribir documentación interna de ingeniería y mantenerla en un repositorio Git.
  • Crear un tutorial extenso o apuntes de un curso como sitio web navegable.

Antes de usarlo

  • Está bajo la licencia MPL-2.0, una licencia copyleft a nivel de archivo, por lo que los archivos de código fuente modificados deben seguir bajo MPL-2.0.

Temas

#markdown#documentation#static-site#rust#book#command-line

Preguntas frecuentes

¿Qué es mdBook?
Una herramienta de línea de comandos escrita en Rust que genera libros en línea a partir de archivos Markdown, similar a GitBook. mdBook convierte un directorio de archivos Markdown en un libro en línea moderno y fácil de navegar. Está pensado para documentación y contenido extenso, como guías de programación; la propia Guía del usuario del proyecto está hecha con él.
¿mdBook es gratuito? ¿Qué licencia tiene?
mdBook es open source bajo la licencia MPL-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mdBook sigue mantenido?
Mantenimiento activo. El último commit de mdBook fue el 21 oct 2026.
¿Para qué puedo usar mdBook?
Publicar la guía de usuario de un lenguaje de programación o una biblioteca. Escribir documentación interna de ingeniería y mantenerla en un repositorio Git. Crear un tutorial extenso o apuntes de un curso como sitio web navegable.
¿Dónde consigo mdBook?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/rust-lang/mdBook

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados