menu

Jekyll

Jekyll es un generador de sitios web estático que utiliza archivos en formato Markdown como base.

Visión general

¿Conoce Ruby? Entonces, ese fue el lenguaje de programación elegido para desarrollar Jekyll.

El programa es gratuito y de código abierto.

Entre miles de sitios que usan Jekyll para convertir archivos Markdown a HTML, vale la pena mencionar uno de ellos, las páginas GitHub.

GitHub Pages utiliza Jekyll como la herramienta principal para convertir archivos Markdown a HTML en su servicio gratuito de alojamiento de sitios web.

El procesador Markdown que utiliza la aplicación es kramdown.

Jekyll carga kramdown con la configuración predeterminada, pero puede cambiarla como se muestra en el siguiente ejemplo.

kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3

El archivo de configuración se llama _config.yml, puede hacer clic aquí para obtener más información sobre la configuración de Jekyll.

Sitio web oficial: https://jekyllrb.com/

Soporte para Markdown en Jekyll

La Tabla 1.1 presenta los elementos Markdown compatibles con Jekyll.

Elemento Soporte Información
Títulos
Párrafos
Saltos de línea
Negrita
Itálico
Blockquote
Listas ordenadas
Listas desordenadas
Código
Lineas horizontales
Links
Imagenes
Tablas
Bloques de código cercados Ingrese la opción syntax_highlighter: rouge en la sección kramdown del archivo _config.yml para habilitar el resaltado de lenguaje dentro del bloque.
Notas al pie
ID de título
Listas de definiciones
Tachado Para tachar una palabra en Jekyll use dos mosaicos ~~palabra~~ o simplemente un mosaico ~palabra~ alrededor del contenido. Ambas sintaxis funcionan.
Listas de tareas
Emoji (copiar y pegar)
Emoji (códigos de acceso) No Jekyll no proporciona soporte por defecto, pero puede agregar plugin jemoji.
Link automático de URL
Desactivar link automático de URL
HTML

Soporte para elementos de sintaxis adicionales

En Tabla 1.2 puede encontrar elementos más oscuros compatibles con Jekyll.

Elemento Markdown Salida
Abreviatura *[HTML]: Hyper Text Markup Language
La especificación HTML es mantenida por el W3C.
La especificación de HTML es mantenida por el W3C

Vea también

Opciones de configuración de Markdown en Jekyll

Documentación de kramdown