AsciiDoc | Example Hugo site with Toph themehttps://justwheel.github.io/toph-hugo-theme/es/tags/asciidoc/Honorary biography page of Septima Clark, a Civil Rights Movement pioneer and activist.Hugo -- gohugo.ioesSeptima Poinsette ClarkMon, 01 Jan 0001 00:00:00 +0000Compatibilidad con las admoniciones de AsciiDochttps://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-admonitions/Sun, 05 Jul 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-admonitions/

AsciiDoc ofrece cinco tipos de admoniciones integrados para llamar la atención sobre contenido específico. Toph da estilo a cada tipo como una tarjeta de aviso refinada con un borde izquierdo de color, un fondo con tono suave y un icono.

Tipos de admoniciones

AsciiDoc define cinco tipos de admoniciones, cada una con un propósito diferente.

Note
 Usa las notas para proporcionar contexto adicional o información complementaria que respalde el texto principal.
Tip
 Usa los consejos para compartir buenas prácticas, atajos o recomendaciones que ayuden al lector.
Warning
 Usa las advertencias para alertar al lector sobre posibles problemas o dificultades que debe tener en cuenta.
Caution
 Usa las precauciones para señalar acciones que podrían causar daño, pérdida de datos o consecuencias no deseadas si se realizan sin cuidado.
Important
 Usa las admoniciones importantes para resaltar información crítica que el lector no debe pasar por alto.

Admoniciones en bloque

Las admoniciones también pueden abarcar varios párrafos usando la sintaxis de bloque de AsciiDoc. Esto es útil cuando el mensaje necesita más de una oración.

Note

Las admoniciones en bloque usan la sintaxis delimitadora con cuatro signos de igual. Pueden contener varios párrafos, listas y otros elementos de AsciiDoc.

Este es un segundo párrafo dentro de la misma admonición.
Tip

Al escribir documentación, considera qué tipo de admonición se ajusta mejor a tu mensaje.

  • NOTE para contexto complementario

  • TIP para consejos prácticos

  • WARNING para posibles dificultades

  • CAUTION para riesgo de daño o pérdida de datos

  • IMPORTANT para información crítica
Warning

Las admoniciones deben usarse con moderación. El uso excesivo diluye su impacto y dificulta la lectura rápida del contenido.

Sintaxis

Hay dos formas de escribir admoniciones en AsciiDoc.

Sintaxis en línea

La forma más simple coloca la etiqueta de la admonición al principio de un párrafo:

NOTE: Esta es una nota en línea.

TIP: Este es un consejo en línea.

Sintaxis en bloque

Para admoniciones de varios párrafos, usa el delimitador de bloque:

[NOTE]
====
Primer párrafo de la admonición.

Segundo párrafo de la admonición.
====

Más información

]]>Blogging con AsciiDoc en Tophhttps://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-blogging/Mon, 23 Mar 2026 00:00:00 +0000https://justwheel.github.io/toph-hugo-theme/es/blog/asciidoc-blogging/

Toph trata a AsciiDoc como un formato de contenido de primera clase. Todo lo que funciona con Markdown también funciona con AsciiDoc: insignias de taxonomía, metadatos de publicaciones, imágenes de portada, anclas de encabezado y navegación.

¿Por qué AsciiDoc?

AsciiDoc ofrece funciones que Markdown no tiene:

  • Tabla de contenido nativa con el atributo de documento :toc:

  • Bloques de admonición (NOTE, TIP, WARNING, IMPORTANT, CAUTION)

  • Directivas de inclusión para reutilizar contenido entre páginas

  • Soporte integrado para tablas complejas y listas anidadas

Si ya te sientes cómodo escribiendo en AsciiDoc, Toph atenderá tus necesidades sin compromisos.

Crear una publicación en AsciiDoc

Crea un archivo con la extensión .adoc en tu directorio de blog:

hugo new blog/my-post.adoc

Añade el front matter en YAML al principio del archivo, seguido del contenido en AsciiDoc:

---
title: "Título de mi publicación"
date: 2026-01-15
draft: false
categories:
  - "tech"
tags:
  - "hugo"
  - "asciidoc"
author: "Nombre del autor"
description: "Un breve resumen de la publicación."
---

Tu contenido en AsciiDoc comienza aquí.

Tabla de contenido

Para habilitar una tabla de contenido, añade el atributo :toc: después del front matter:

---
title: "Título de mi publicación"
toc: true
---
:toc:

== Primera sección

El CSS de Toph da estilo a la tabla de contenido generada por AsciiDoc de forma idéntica a la opción toc: true del front matter de Markdown. Ambos formatos producen el mismo resultado visual.

Anclas de encabezado

Aparecen enlaces de anclaje en los que se puede hacer clic (🔗) al pasar el cursor sobre todos los encabezados de sección. Para Markdown, esto se gestiona mediante un render hook. Para AsciiDoc, Toph inyecta el mismo marcado de anclaje mediante el procesamiento de plantillas. Ambos formatos producen resultados idénticos.

Más información

]]>