GitBook
GitBook es una herramienta online que aloja sitios de documentación con soporte para Markdown.
Visión general
Como es una herramienta online, GitBook tiene un editor Markdown que se ejecuta directamente en su navegador, por lo que la herramienta ofrece mucha practicidad para que pueda crear su documentación.
Si necesita más control sobre su contenido, GitBook también admite integración con repositorios GitHub.
Con GitBook puedes crear tu sitio web y luego publicarlo usando un dominio personalizado.
Pero vale la pena mencionar que, GitBook comenzó como un proyecto de código abierto y solo tenía una pequeña oferta comercial para recaudar fondos para la empresa.
Hoy en día, la herramienta está cerrada y es propietaria, así que tenlo en cuenta si planeas adherirte al uso de GitBook.
El proyecto de código abierto todavía existe y puede ser utilizado por cualquiera, pero GitBook ya no es compatible con ese proyecto, por lo que solo se enumerarán los elementos Markdown compatibles con la herramienta propietaria.
Aunque la aplicación está cerrada, GitBook todavía tiene ventajas sobre otras herramientas de este tipo.
Por ejemplo, la construcción y el alojamiento del sitio web es responsabilidad del propio programa.
GitBook proporciona un editor Markdown muy intuitivo, con controles WYSIWYG fáciles de usar.
Así que incluso los usuarios novatos se sienten cómodos editando documentos Markdown.
Otra característica interesante de la herramienta es que oculta las marcas Markdown mientras escribe.
El editor puede parecer extraño al principio, pero con el tiempo lo dominas.
GitBook también es compatible con copiar y pegar, tome su contenido Markdown y péguelo directamente en la interfaz de la herramienta.
El sitio web oficial de GitBook se encuentra en https://www.gitbook.com/.
Soporte para Markdown en GitBook
La Tabla 1.1 muestra los elementos Markdown compatibles con GitBook.
| Elemento | Soporte | Información |
|---|---|---|
| Títulos | Sí | |
| Párrafos | Sí | |
| Saltos de línea | Sí | |
| Negrita | Sí | |
| Itálico | Sí | |
| Blockquote | Sí | |
| Listas ordenadas | Sí | |
| Listas desordenadas | Sí | |
| Código | Sí | |
| Lineas horizontales | No | |
| Links | Sí | |
| Imagenes | Sí | |
| Tablas | Sí | |
| Bloques de código cercados | Sí | También puede resaltar la sintaxis del lenguaje de programación del bloque. |
| Notas al pie | No | |
| ID de título | Sí | |
| Listas de definiciones | No | |
| Tachado | Sí | |
| Listas de tareas | Sí | |
| Emoji (copiar y pegar) | Desconocido | |
| Emoji (códigos de acceso) | Desconocido | |
| URL Link automático | Sí | |
| Desactivar link automático de URL | No | |
| HTML | Sí |