Cómo escribir un libro en GitHub

GitbookIO / gitbook es un buen punto de partida. Le permitirá crear usando Markdown. Puede alojar el libro generado en las páginas de GitHub. También es fácil generar PDF, ePub y MOBI.

Una alternativa sería simplemente crear el libro directamente en un wiki de GitHub. La desventaja de esto es que será imposible aceptar solicitudes de extracción. Pero si no te importa eso, podría ser un camino a seguir. bebraw / ghw, una herramienta que he desarrollado, le permite transformar su contenido wiki en formato compatible con las páginas de GitHub.

Si se trata de un libro corto, puede escribirlo en el proyecto README.md y luego dividirlo para separar los archivos de Markdown a medida que crece (es decir, usar 00_, 01_, 02_, … convención de prefijo para mantenerlo ordenado). También puede convertir esto a un sitio de páginas de GitHub con algún script personalizado.