Uso de GitHub Wiki, Liquid, Jekyll y Markdown

 

Informe: Uso de GitHub Wiki, Liquid, Jekyll y Markdown

GitHub Wiki
GitHub Wiki es una herramienta integrada en los repositorios que permite crear documentación colaborativa, como si fuera una pequeña página web del proyecto. Se escribe generalmente en Markdown, lo que facilita la redacción. Se usa para explicar el funcionamiento de un proyecto, mantener guías, manuales de instalación, etc. No requiere conocimientos de programación y se gestiona como un repositorio separado.

Markdown
Es un lenguaje de marcado ligero utilizado para dar formato a los textos en GitHub. Se usa en archivos .md como README.md y en la Wiki. Permite escribir títulos, listas, enlaces, imágenes y bloques de código de forma sencilla y legible. Es clave para toda la documentación en GitHub porque se transforma automáticamente en HTML cuando se muestra en el navegador.

Jekyll
Jekyll es un generador de sitios estáticos que convierte archivos Markdown en páginas HTML. GitHub Pages lo usa para permitir que los usuarios creen sitios web desde repositorios sin necesidad de backend. Es ideal para blogs, portfolios y documentación. Utiliza carpetas como _layouts, _includes y soporta temas para definir la apariencia del sitio.

Liquid
Liquid es un lenguaje de plantillas usado dentro de Jekyll para incrustar lógica en archivos HTML o Markdown. Permite insertar variables, hacer condicionales, bucles y reutilizar componentes. Es similar a un lenguaje de programación, pero enfocado en diseño de plantillas. Jekyll interpreta las plantillas Liquid cuando construye el sitio.

---

Ejemplos mínimos

Ejemplo de código Liquid (usado dentro de archivos Jekyll como .html o .md):

liquid
{% if page.title %}
  <h1>{{ page.title }}</h1>
{% endif %}

Esto muestra un título solo si la página tiene uno definido.

Ejemplo de Jekyll con Markdown y Liquid combinado:

Archivo: about.md

markdown
---
layout: default
title: Sobre mí
---

# {{ page.title }}

Hola, este sitio fue generado con Jekyll.

• --- define el encabezado YAML que Jekyll usa para procesar la página.

• {{ page.title }} es código Liquid que inserta el título de la página.

• El resto es Markdown para el contenido.