GitHub Pages
GitHub Pages es un servicio de Web que permite al usuario alojar un sitio web gratuito creado a partir de archivos Markdown.
Visión general
Si ya tiene experiencia con GitHub y necesita alojar un sitio web en internet, puede utilizar directamente el servicio de almacenamiento de páginas GitHub.
Vale la pena mencionar que las páginas alojadas en GitHub Pages son páginas simples, como páginas en HTML, no hay un servidor para ejecutar PHP, Python o Ruby y ni siquiera una base de datos.
Para alojar un sitio web, simplemente cree un nuevo repositorio, inserte sus archivos formateados en Markdown y active la función de páginas GitHub.
GitHub Pages es una de las herramientas con mayor compatibilidad con Markdown utilizando como base el generador de sitios web estáticos Jekyll.
La herramienta también ofrece temas que el usuario puede elegir para componer su sitio web.
Por supuesto, puede crear un sitio web y formatearlo usando su propio CSS.
A continuación, puede ver una página Web construida con uno de los temas ofrecidos por GitHub Pages.
Solo por curiosidad, GitHub Pages y GitHub usan diferentes procesadores Markdown. GitHub tiene su propio procesador Markdown, mientras que GitHub Pages usa jekyll-commonmark.
Con esta diferencia entre los procesadores Markdown, algunos formatos pueden aparecer de manera diferente en su archivo README.md.
El más notorio sería el uso de emoticons, el sitio de GitHub se renderizaría y el sitio generado por GitHub Pages no.
https://pages.github.com/ es el sitio web oficial de GitHub Pages.
Soporte para Markdown en páginas GitHub
En Tabla 1.1 se presentan los elementos Markdown compatibles con las Páginas GitHub.
| 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 | Sí | |
| Links | Sí | |
| Imagenes | Sí | |
| Tablas | Sí | |
| Bloques de código cercados | Sí | Puedes resaltar el código del bloque, pero para eso es necesario verificar si la opción syntax_highlighter: rouge se encuentra en el archivo de configuración _config.yml, esta opción se encuentra en la sección kramdown. |
| Notas al pie | Sí | |
| ID de título | Sí | |
| Listas de definiciones | Sí | |
| Tachado | Sí | GitHub Pages proporciona soporte de sintaxis con dos mosaicos ~~palabra~~ o simplemente uno ~palabra~, ambos funcionan. |
| Listas de tareas | Sí | |
| Emoji (copiar y pegar) | Desconocido | |
| Emoji (códigos de acceso) | Desconocido | |
| Link automático de URL | Sí | |
| Desactivar link automático de URL | Sí | |
| HTML | Sí |
Soporte para elementos de sintaxis adicionales
La Tabla 1.2 muestra elementos que no son tan familiares para los usuarios de Markdown que son compatibles con GitHub Pages.
| Elemento | Markdown | Salida |
|---|---|---|
| Abreviatura | *[HTML]: Hyper Text Markup LanguageLa especificación de HTML es mantenida por el W3C. |
La especificación de HTML es mantenida por el W3C. |