Callouts en Obsidian: Sintaxis, Tipos, Ejemplos y CSS Personalizado

Los callouts (bloques de llamada o destacado) de Obsidian te permiten resaltar, agrupar y ocultar cierto contenido dentro de tus notas mediante una sintaxis sencilla basada en bloques de cita. Ya sea que quieras llamar la atención sobre consejos de examen, crear listas de tareas desplegables o separar las notas del autor del texto del manuscrito, los callouts proporcionan una forma flexible de organizar la información sin romper tu flujo de escritura.

Respuesta rápida: Cómo crear un Callout en Obsidian

Sí. Los callouts de Obsidian son bloques de cita estilizados que utilizan > [!type] en la primera línea. Esta guía te proporciona la sintaxis, ejemplos listos para copiar y pegar, tipos integrados, reglas de plegado y anidamiento, además de soluciones para problemas comunes con CSS personalizado. Consulta la referencia oficial de callouts para verificar la lista de tipos actual y los comandos del editor.

Aquí tienes la sintaxis básica para crear un callout:

> [!note] Este es un callout.

• Usa > [!type] en la primera línea de un bloque de cita

• Reemplaza note por otro tipo como tip, warning o question

• Presiona Intro y continúa con > para añadir contenido multilínea

• En Live Preview, usa la paleta de comandos y selecciona Insert callout para añadir al instante un bloque de callout predeterminado. También puedes seleccionar texto existente y ejecutar el mismo comando para envolverlo en un callout.

¿Qué son los Callouts de Obsidian?

Los callouts son bloques de cita con estilos que Obsidian renderiza con colores, iconos y comportamiento de plegado opcional. Se introdujeron a mediados de 2022 y se han convertido en una función básica para organizar notas de forma visual.

Cuando Obsidian encuentra un bloque de cita que comienza con [!type], lo procesa de forma especial y muestra una caja de destacado en lugar de un bloque de cita común. Dentro del cuerpo, puedes usar sintaxis markdown estándar, wikilinks, incrustaciones, tareas, bloques de código y enlaces internos.

Visualmente, un callout se muestra con una barra lateral coloreada, un icono (como una bombilla para consejos o un signo de exclamación para advertencias), una barra de título opcional y el texto del cuerpo debajo.

Usos comunes incluyen:

• Resumir puntos clave en la parte superior de las notas de reunión

• Destacar material relevante para exámenes en notas de estudio

• Añadir cajas de spoiler en anotaciones de libros

Ten en cuenta que los callouts solo se renderizan con este diseño dentro de Obsidian. En visores de markdown plano o en GitHub, aparecen como bloques de cita anidados ordinarios; el contenido sigue siendo legible, simplemente sin el estilo visual.

Sintaxis y configuración de los Callouts

Esta sección cubre todos los elementos de sintaxis: tipo, título, plegado y contenido del cuerpo.

La estructura básica es la siguiente:

> [!note] Texto del título
> El contenido del cuerpo va aquí
> - Los puntos de viñeta también funcionan

La primera línea contiene tres partes:

• Identificador de tipo entre corchetes: [!note], [!warning], [!tip]

• Marcador de plegado opcional: + o - directamente después del tipo (ej. [!tip]-)

• Título personalizado opcional después del tipo (ej. [!tip] Pista de examen)

Las líneas del cuerpo comienzan con > como los bloques de cita normales y pueden incluir listas, bloques de código, imágenes o casillas de tareas.

La palabra clave del tipo no distingue entre mayúsculas y minúsculas: [!NOTE], [!Note] y [!note] funcionan de manera idéntica para los callouts integrados.

Cambiar títulos de Callouts

Por defecto, Obsidian utiliza el nombre del tipo como título (ej. “Note” o “Warning”).

Para invalidar el título predeterminado:

> [!warning] Lee esto antes de desplegar

Compara estos dos enfoques:

• > [!tip] se muestra con el encabezado predeterminado “Tip”

• > [!tip] Flujo de trabajo más rápido muestra en su lugar “Flujo de trabajo más rápido”

Un callout de solo título también funciona: simplemente usa una sola línea como > [!info] Requisitos del sistema sin líneas de cuerpo a continuación.

Los títulos pueden contener emoticonos, wikilinks y formato como texto en negrita.

Callouts Plegables (Desplegables)

Añadir un signo más o un signo menos directamente después del tipo controla si el callout se puede plegar:

• > [!note]+ Siempre expandido por defecto

• > [!note]- Plegado por defecto

Ambos marcadores hacen que el callout sea plegable. El signo determina si empieza abierto o cerrado.

Los usos prácticos para callouts plegables incluyen:

• Ocultar soluciones detalladas en notas de estudio

• Plegar listas de verificación largas bajo un encabezado [!todo]-

• Guardar spoilers en notas de libros

En los modos de Lectura y Live Preview, los usuarios hacen clic en el icono de triángulo para expandir o plegar. En modo Código Fuente, el marcador de plegado aparece como markdown puro.

Callouts Anidados

Puedes anidar callouts colocando otro bloque de callout dentro del cuerpo de un callout primario.

Las líneas del callout interior usan un > adicional para cada nivel de anidamiento:

> [!warning] Problema potencial
>> [!tip] Aquí hay una solución

Esto crea un callout de advertencia que contiene un consejo anidado. Otro ejemplo: un [!question] con respuestas [!example] anidadas.

Limita la profundidad de anidamiento para mantener la legibilidad; dos niveles suelen ser suficientes.

Tipos de Callouts admitidos en Obsidian

Obsidian viene con tipos integrados, cada uno asignado a un color e icono. Los tipos no admitidos adoptan por defecto el estilo de note.

Tipos predeterminados comunes y sus alias:

• note: información general

• abstract / summary / tldr: resúmenes

• info: contexto adicional

• todo: tareas y elementos de acción

• tip / hint / important: consejos y puntos clave

• success / check / done: elementos completados

• question / help / faq: preguntas

• warning / caution / attention: problemas potenciales

• failure / fail / missing: información faltante

• danger / error: problemas graves

• bug: errores de software

• example: ejemplos de código o conceptuales

• quote / cite: citas destacadas

Diferentes temas de la comunidad pueden rediseñar estos tipos, por lo que el mismo [!warning] puede verse diferente entre temas.

En Live Preview, haz clic con el botón derecho en la barra lateral de un callout para cambiar su tipo desde un menú contextual en lugar de editar el markdown manualmente.

Los tipos desconocidos como [!idea] se muestran visualmente como note, pero permanecen disponibles para personalización mediante CSS.

¿Qué Callout deberías usar?

El tipo controla la señal, no solo el color. Elige una pequeña convención que te diga qué hacer cuando escanees la nota más tarde:

Lo que necesitas señalar	Buen tipo de inicio	Patrón útil
Contexto o una definición	info o abstract	Pon la explicación junto a la afirmación que respalda.
Una siguiente acción	todo	Mantén la lista de verificación cerca del proyecto o reunión.
Una decisión o riesgo	question, warning o tipo personalizado	Haz visible el punto no resuelto sin enterrarlo en la prosa.
Un detalle secundario	Plegable example o note	Usa - para mantener el detalle colapsado por defecto.
Un resultado completado	success o done	Resérvalo para un resultado, no para cada frase positiva.

Para una bóveda de productividad, un mínimo práctico es todo para acciones, warning para bloqueos, question para decisiones abiertas y summary para notas de revisión.

Formas prácticas de usar Callouts en tu bóveda

Así es como encajan los callouts en flujos de trabajo reales:

• Estudio y aprendizaje: Usa [!tip] para pistas de examen, [!question]- para preguntas de práctica con soluciones plegadas, [!summary] en la parte superior de las notas de clase.

• Desarrollo de software: Añade [!warning] alrededor de comandos destructivos, [!bug] para problemas conocidos, [!example] para fragmentos de uso de API.

• Gestión de proyectos y tareas: Almacena listas de verificación en callouts [!todo]+ agrupados por hito, conviértelos en [!success] al finalizar.

• Escritura de formato largo: Separa las notas del autor mediante [!note]- o tipos personalizados, marca pistas de trama como [!clue] en borradores.

• Base de conocimiento personal: Usa [!info] para hechos clave, [!quote] para citas, [!danger] para advertencias críticas.

Combina callouts con plantillas de Obsidian ya preparadas. Para flujos de reuniones, consulta nuestra guía de plantillas de reuniones en Obsidian.

Callouts para Tareas y Listas de Verificación

Las tareas dentro de callouts se comportan como tareas normales de Obsidian y aparecen en la búsqueda global de tareas.

Un callout [!todo] agrupa casillas relacionadas:

> [!todo]+ Lista de verificación del lanzamiento 1.2
> - [ ] Actualizar CHANGELOG para la versión 2025-04-01
> - [ ] Ejecutar pruebas de regresión

Cambia el tipo de todo a success para señalar visualmente la finalización de un bloque entero.

Callouts en Flujos de Trabajo de Publicación

Los callouts son herramientas de edición interna y a menudo no deben aparecer en exportaciones finales como libros, PDF o entradas de blog.

Los complementos como Longform permiten añadir un paso de preprocesamiento para eliminar el marcado de callout antes de compilar. Un script escanea líneas que comienzan con > [! y elimina la estructura manteniendo o descartando el cuerpo.

Personalización de Callouts con CSS

Obsidian expone los callouts a través de atributos data-callout, lo que te permite definir tipos personalizados con CSS propio.

El patrón:

1. Elige un identificador de tipo personalizado como idea

2. Úsalo en notas: > [!idea] Nuevo concepto de producto

3. En CSS, apunta a .callout[data-callout="idea"] con colores e icono únicos.

Obsidian utiliza iconos Lucide. La API de CSS admitida utiliza --callout-color y --callout-icon; la referencia para desarrolladores sobre variables CSS de callout enumera las variables disponibles.

Ejemplos de Callouts Personalizados Útiles

Ideas concretas de tipos personalizados:

• [!clue]: Para escritores que rastrean pistas de la trama entre capítulos.

• [!risk]: En documentación técnica para señalar riesgos técnicos o de negocio.

• [!meeting]: Para resúmenes de acciones al inicio de notas de reuniones.

• [!definition]: En una base de conocimiento para estandarizar entradas de terminología.

Añade estos estilos agregando un fragmento (snippet) CSS en la carpeta .obsidian/snippets de tu bóveda.

Solución de problemas de CSS

Verifica esto en orden:

1. Coloca el archivo CSS en la carpeta .obsidian/snippets de la bóveda, actívalo en Ajustes → Apariencia → Snippets CSS y recarga los snippets.
2. Haz coincidir exactamente el tipo en la nota y en el selector. Por ejemplo, [!decision] requiere .callout[data-callout="decision"].
3. Mantén los nombres de tipos personalizados en minúsculas en ambos lugares. Los identificadores integrados no distinguen entre mayúsculas y minúsculas, pero un informe de solución de problemas del foro de Obsidian muestra que una discrepancia de mayúsculas puede impedir que un selector personalizado coincida.
4. Utiliza un icono incluido en tu versión instalada de Obsidian.

Búsqueda, Gestión y Exportación de Callouts

Busca callouts mediante consultas como "[!todo]" para encontrar todos los callouts de tareas. Combínalo con filtros de ruta: path:"Drafts" "[!clue]".

Limitaciones y Compatibilidad

Los callouts no forman parte del estándar CommonMark. En editores como Typora o en GitHub, se degradan a citas de bloque anidadas simples.

Algunas aplicaciones Markdown móviles los muestran como texto plano: el contenido sigue siendo legible pero sin colores ni iconos.

El uso intensivo de callouts anidados y replegables puede ralentizar el procesamiento en dispositivos móviles más antiguos.

Prueba periódicamente las exportaciones (PDF, DOCX, HTML) para verificar que el contenido crítico dentro de los callouts se muestre correctamente. Considera mantener un documento de guía de estilo en tu bóveda para que los colaboradores sigan las mismas convenciones.

Errores de sintaxis comunes

El marcador de plegado debe tocar el identificador de tipo:

> [!faq]- Colapsado por defecto
> Este contenido comienza oculto.

> [!faq] - Colapsado por defecto tiene un espacio antes del guión, por lo que no es la sintaxis de plegado documentada. Si el plegado sigue sin aparecer, verifica que la nota esté en Vista de Lectura o Vista Previa en Vivo y compara el bloque con el ejemplo oficial. Un informe del foro de Obsidian de 2024 identificó el espacio extra como la causa de un callout que no se replegaba.

Los callouts son una extensión de Obsidian, no CommonMark estándar. Si un callout parece una cita de bloque plana en otro editor de Markdown, es lo esperado; el contenido sigue siendo legible, pero el estilo y el comportamiento de plegado de Obsidian pueden no trasladarse.

Conclusión

Los callouts de Obsidian son bloques de cita mejorados que te permiten resaltar, agrupar y opcionalmente ocultar información sin interrumpir el flujo de tu nota.

Puntos clave:

• Aprende la sintaxis básica: > [!type] Título

• Elige un conjunto pequeño de tipos que se adapten a tu flujo de trabajo

• Añade CSS personalizado solo donde apoye tu proceso

Si quieres tener conectados tus diarios, proyectos, revisiones y plantillas de reuniones desde el principio, Obsibrain te ofrece un sistema local listo para usar en Obsidian.