Guía Markdown de Hugo

Hugo es una herramienta desarrollada con Go repleta de funcionalidades que permite generar webs estáticas.

Acerca de Hugo

El punto más fuerte de hugo es velocidad, ya que gracias a Go apenas tardará unos segundos en generar una web con cientos o miles de páginas. Son muchos los sitios web actuales que usan Hugo para sus contenidos, incluso aquellos con decenas de miles de artículos. Hugo se posiciona actualmente como una de las mejores alternativas a WordPress.

Imagen de Hugo

Hugo tiene un excelente soporte para Markdown, ya que usa el procesador Markdown Goldmark, compatible con la sintaxis CommonMark.

Hugo te proporciona multitud de shorcodes adicionales que se integran con la sintaxis Markdown. Además, si quieres configurar el aspecto de Hugo, tienes centenas de temas disponibles. Si no son suficientes, podrás crear tu propio tema.

Instalación de Hugo

Puedes instalar Hugo tanto para Linux como para Windows y macOS. Para ello debes saber usar la línea de comandos.

Instalación en Windows

Para instalar Hugo en Windows con Chocolatey, abre una ventana de Línea de comandos de Windows y usa este comando:

choco install hugo -confirm

O en caso de que prefieras usar la versión Sass/SCSS en Windows, debes usar este comando:

choco install hugo-extended -confirm

Para instalar Hugo en Windows con Scoop, usa este comando:

scoop install hugo-extended

O en caso de que prefieras la versión extendida, debes usar este otro comando:

scoop install hugo-extended

Instalación en macOS

Para instalar Hugo en macOS con Homebrew, abre una ventana de Línea de comandos de macOS y usa este comando: usa este comando:

brew install hugo

Para instalar Hugo en macOS con Ports, usa este comando:

port install hugo

Instalación en Linux

Para instalar Hugo en Linux con Homebrew, abre una ventana de Línea de comandos de Linux y usa este comando: usa este comando:

brew install hugo

Configuración de Hugo

Hugo dispone de muchísimas extensiones, pudiendo configurar las opciones de Goldmark desde el archivo config.toml que ves aquí:

baseURL = "https://miweb.tld/"
languageCode = "es-es"
title = "Mi web"
theme = "ananke"

[markup]
taskLists = false

También puedes configurar tanto la sintaxis Markdown como la sintaxis Markup de Hugo. Para ello, consutla la guía de configuración de la sintaxis de Hugo

Soporte Markdown

Hugo soporta todos los elementos de la sintaxis básica de Markdown y también los de la avanzada, siendo una de las herramientas con más compatibilidad con este lenguaje. En la siguiente tabla puedes ver cuáles son los elementos de Markdown compatibles con Hugo:

Elemento	Soporte	Notas
Encabezados	Sí
Párrafos	Sí
Saltos de línea	Sí	Puedes usar una barra invertida `\` para saltar de línea en luegar de los dos espacios en blanco.
Negrita	Sí
Cursiva	Sí
Citas	Sí
Listas ordenadas	Sí
Listas no ordenadas	Sí
Código	Sí
Línea horizontal	Sí
Enlaces	Sí
Imágenes	Sí
HTML	Sí	Desactivado por defecto
Tablas	Sí
Bloques de código avanzados	Sí
Resaltado de sintaxis	Sí
Notas al pié	Sí
IDs de cabecera	Sí
Listas de definiciones	Sí
Texto tachado	Sí
Listas de tareas	Sí
Emojis (copiar y pegar)	Sí
Emojis (shortcodes)	Sí
Enlaces automáticos	Sí
Deshabilitar enlaces automáticos	Sí

Debes tener en cuenta que la inserción de código HTML estará disactivada por defecto si usas Goldmark. Para activarlo, establece el valor de la opción unsafe como true en la Configuración de Goldmark.

Alternativas a Hugo

Si buscas alguna alternativa a Hugo, podrías probar algún otro generador estático, como por ejemplo Jekyll.

Si lo que vas a crear es la documentación de algún proyecto, tus mejores opciones son Docusaurus o MkDocs.

Más información

Si quieres saber más cosas acerca de Hugo, consulta los siguientes enlaces:

Web: Accede a la web de Hugo
Repositorio: Accede al repositorio de Hugo
Documentación: Accede a la documentación de Hugo