Guía rápida de Markdown en Obsidian

Utiliza esta página como referencia rápida de copiar y pegar para el código Markdown que más utilizas en Obsidian. Cubre el Markdown estándar, las extensiones propias de Obsidian como wikilinks y callouts, y los atajos de teclado que te ayudan a editar tus notas rápidamente.

Obsidian parte de CommonMark y GitHub-Flavored Markdown, y añade funciones para conectar notas: [[wikilinks]], ![[incrustaciones]], callouts, resaltados, comentarios, referencias de bloques y propiedades. El Markdown estándar suele ser la opción más portable; la sintaxis de Obsidian es la mejor elección cuando la nota está pensada para funcionar dentro de tu bóveda (vault).

Referencia rápida

Necesidad	Sintaxis	Ejemplo
Encabezado	# a ######	## Notas del proyecto
Negrita	**texto**	**importante**
Cursiva	*texto*	*opcional*
Tachado	~~texto~~	~~plan antiguo~~
Resaltado	==texto==	==decisión==
Enlace externo	[etiqueta](url)	[Ayuda de Obsidian](https://obsidian.md/help)
Enlace interno	[[Nota]]	[[Resumen del proyecto]]
Tarea	- [ ]	- [ ] Enviar seguimiento
Callout	> [!tipo]	> [!tip] Prueba este flujo de trabajo
Nota incrustada	![[Nota]]	![[Notas de reunión]]
Código en línea	`código`	`status: borrador`
Comentario	%%texto%%	%%Visible solo durante la edición%%

Formato de texto y estructura

# Encabezado 1
## Encabezado 2
### Encabezado 3

**Texto en negrita**
*Texto en cursiva* o _texto en cursiva_
***Texto en negrita y cursiva***
~~Texto tachado~~
==Texto resaltado==

> Una cita en bloque puede contener un fragmento útil o un recordatorio.

---

Usa una línea en blanco para comenzar un nuevo párrafo. Un solo Enter dentro de un párrafo se trata normalmente como un salto de línea suave. Para un salto de línea duro, usa Shift+Enter o añade dos espacios antes de presionar Enter. Si necesitas un comportamiento compatible con Markdown entre varios editores, activa Ajustes → Editor → Saltos de línea strictly.

Para mostrar caracteres de Markdown de forma literal, escápalos con una barra invertida:

\*Esto no es cursiva\*
1\. Esto no es un elemento de lista
\# Esto no es un encabezado

Listas, listas de verificación y anidamiento

- Primer elemento
- Segundo elemento
  - Elemento anidado

1. Primer paso
2. Segundo paso

- [ ] Tarea pendiente
- [x] Tarea completada
  - [ ] Subtarea

En la vista de lectura, puedes hacer clic en la casilla de verificación de una tarea para cambiar su estado. Para fechas de vencimiento, tareas recurrentes y consultas entre notas, consulta la guía completa de gestión de tareas en Obsidian.

Enlaces e incrustaciones

Enlaces internos

[[Nombre de nota]]
[[Nombre de nota|Texto a mostrar]]
[[Nombre de nota#Encabezado]]
[[Nombre de nota#Encabezado|Texto a mostrar]]
[[Nombre de nota#^block-id]]

[[Nombre de nota]] enlaza a otra nota en la bóveda. Añade | para un alias, # para un encabezado o #^ para una referencia de bloque. Usa el prefijo ! para incrustar en lugar de solo enlazar:

![[Nombre de nota]]
![[Nombre de nota#Encabezado]]
![[Nombre de nota#^block-id]]
![[imagen.png]]
![[imagen.png|400]]

Las incrustaciones son útiles cuando una definición reutilizable, una decisión de reunión o una lista de verificación debe aparecer en más de un lugar mientras sigue siendo editable en la nota de origen.

Enlaces externos e imágenes

[Ayuda de Obsidian](https://obsidian.md/help)
![Descripción](https://example.com/imagen.png)

Usa un texto de enlace descriptivo. Para las notas que puedan salir de tu bóveda, los enlaces estándar de Markdown son más portables que los wikilinks.

Tablas

Una tabla necesita una fila de encabezado y una fila delimitadora. Cada celda delimitadora necesita al menos dos guiones:

| Estado | Siguiente acción |
| --- | --- |
| Abierto | Revisar hoy |
| Hecho | Archivar nota |

Alinea las columnas con puntos dobles en la fila delimitadora:

| Izquierda | Centro | Derecha |
| :--- | :---: | ---: |
| A | B | C |

En Vista previa en vivo, usa el menú contextual de la tabla o el comando Insertar tabla para añadir filas y columnas. Si una tabla no se renderiza, comprueba estas causas comunes:

• Añade una línea en blanco antes de la tabla.
• Mantén la fila delimitadora directamente debajo del encabezado.
• Escapa una barra vertical literal dentro de una celda como \|.
• Mantén los bloques de código multilínea fuera de las celdas de la tabla; usa una nota enlazada o incrustada cuando el ejemplo requiera más de una línea.

Callouts

Los callouts son citas en bloque con estilo. El identificador de tipo controla el icono y el color; el título es opcional.

> [!tip] Un título corto
> Mantén el consejo cerca del párrafo que explica.

> [!warning]- Un aviso colapsado
> Este contenido comienza colapsado.

Los tipos integrados comunes incluyen note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example y quote. El sufijo + inicia el callout desplegado; el sufijo - lo inicia colapsado. Consulta la guía completa de callouts de Obsidian para CSS personalizado y solución de problemas.

Código, notas al pie, comentarios y matemáticas

Usa un acento grave para código en línea y tres acentos graves para un bloque de código delimitado. Añade un identificador de lenguaje para la sintaxis destacada:

Usa `Ctrl+P` para abrir la paleta de comandos.

```js
const noteType = "project";
```

Las notas al pie usan una referencia y una definición:

Obsidian guarda las notas como archivos Markdown.[^1]

[^1]: Confirma el comportamiento en la documentación oficial de ayuda de Obsidian.

Los comentarios están ocultos en la vista de lectura y en Obsidian Publish:

Texto visible %%recordatorio solo para el editor%%

Para matemáticas, usa un solo signo de dólar para expresiones en línea y dobles signos de dólar para un bloque:

En línea: $a^2 + b^2 = c^2$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

Atajos de teclado esenciales

Estos son valores predeterminados útiles, no un reemplazo para tu propia configuración de atajos:

Acción	Windows/Linux	macOS
Nueva nota	Ctrl+N	Cmd+N
Paleta de comandos	Ctrl+P	Cmd+P
Pegar sin formato	Ctrl+Shift+V	Cmd+Shift+V
Eliminar línea actual sin selección	Ctrl+Shift+K	Cmd+Shift+K
Negrita en texto seleccionado	Ctrl+B	Cmd+B
Cursiva en texto seleccionado	Ctrl+I	Cmd+I

Obsidian separa los atajos de edición del sistema de los atajos de comandos personalizables. Abre Ajustes → Atajos de teclado para comprobar o cambiar comandos como insertar una plantilla, abrir una nota diaria o ejecutar una acción de un plugin. En un teclado que no sea US, la tecla mostrada puede no coincidir con la etiqueta física.

Tabla práctica de decisiones de formato

Si necesitas…	Prefiere	Por qué
Compartir la nota con otros editores de Markdown	Enlaces, encabezados, listas y tablas estándar de Markdown	Son las estructuras más portables.
Conectar notas en una misma bóveda	Wikilinks y referencias de bloques	Obsidian puede resolver nombres de notas y enlazar a secciones exactas.
Reutilizar una lista de verificación o definición	Una incrustación	Una sola fuente se puede actualizar en varias notas.
Explicar una decisión sin interrumpir la lectura	Un callout	El contenido permanece visible pero visualmente secundario.
Hacer seguimiento de trabajo en notas diarias	Tareas con una plantilla consistente	La sintaxis de tareas sigue siendo legible incluso sin plugins.

Esta distinción evita un fallo común: crear una nota atractiva que solo funciona en una vista o en una sola aplicación. Empieza con Markdown portable y luego añade funciones de Obsidian donde eliminen fricción real.

Lista de verificación para solución de problemas

Cuando el formato no se vea bien en la vista de lectura, comprueba la sintaxis en este orden:

1. Confirma que cada bloque de código delimitado tenga sus comillas invertidas de cierre.
2. Añade una línea en blanco antes de un nuevo párrafo, tabla, lista o callout.
3. Comprueba si un carácter |, *, _, # o acento grave necesita ser escapado.
4. Para una tabla, verifica la fila delimitadora y elimina los bloques multilínea dentro de las celdas.
5. Para los saltos de línea, usa Shift+Enter, dos espacios al final o la opción de Saltos de línea estrictos.
6. Si un comando no se ejecuta, búscalo en la paleta de comandos e inspecciona el atajo asignado.

Para un sistema reutilizable, el formato es solo la primera capa. Una plantilla de nota diaria, un flujo de captura rápida, una revisión semanal y una vista de tareas facilitan pasar a la acción. Obsibrain añade esos flujos de planificación y gestión de tareas dentro de Obsidian.

Referencias oficiales

• Sintaxis básica de formato
• Sintaxis avanzada de formato
• Obsidian Flavored Markdown
• Atajos de edición
• Atajos de teclado
• Callouts

Continúa con la guía de enlaces en Obsidian, callouts o gestión de tareas.