Cómo usar Obsidian paso a paso

Obsidian es una de las aplicaciones de notas más potentes que existen y, a diferencia de la mayoría, guarda todo en archivos Markdown normales dentro de una carpeta de tu ordenador. Esta guía recorre desde la instalación hasta la sintaxis propia de la aplicación, para que puedas montar tu sistema de notas desde cero.

Qué es Obsidian y cómo funciona

Obsidian es un editor de notas local que funciona sobre archivos .md. No hay base de datos ni formato propietario: cada nota que escribes es un archivo de texto plano que puedes abrir con cualquier otro editor, versionar con Git o copiar a otro ordenador.

Una bóveda (vault en inglés) es simplemente una carpeta de tu disco duro. Obsidian la abre, indexa todos los archivos Markdown que encuentra dentro y te deja navegarlos. Esa es la idea clave de toda la aplicación: si mañana dejas de usar Obsidian, tus notas siguen ahí y siguen siendo legibles.

Puedes tener varias bóvedas separadas, por ejemplo una para el trabajo y otra personal, y Obsidian las trata de forma completamente independiente. La aplicación es gratuita para uso personal y está disponible para Windows, macOS, Linux, Android e iOS.

Instalar Obsidian y crear tu primera bóveda

El proceso es rápido y no requiere cuenta ni registro para empezar a usarlo en local.

Descargar la aplicación

Descarga el instalador desde obsidian.md eligiendo tu sistema operativo. La instalación es la habitual de cualquier programa de escritorio y no necesitas crear ninguna cuenta.

Crear la bóveda

Al abrir Obsidian por primera vez te pedirá que crees una bóveda o que abras una carpeta existente. Si ya tienes una carpeta con archivos Markdown, elige la opción de abrir carpeta como bóveda y verás todas tus notas al instante.

Un consejo importante desde el principio: coloca la bóveda en una ruta sencilla y estable, por ejemplo Documentos/Notas. Vas a acumular cientos de archivos ahí dentro y moverla más adelante puede romper enlaces si usas rutas absolutas.

Qué hay dentro de la carpeta

Si abres la carpeta de la bóveda con el explorador de archivos verás tus notas en .md y una carpeta oculta llamada .obsidian. Esa carpeta contiene la configuración, los temas y los plugins de esa bóveda concreta.

Esto significa que la configuración viaja con la bóveda. Si copias la carpeta a otro ordenador, te llevas también tus ajustes y plugins. Si versionas la bóveda con Git, normalmente querrás ignorar parte del contenido de .obsidian para no llenar el historial de cambios de configuración.

Poner Obsidian en español

La interfaz de Obsidian se puede cambiar a español desde los ajustes generales de la aplicación, en la opción de idioma. El cambio afecta a los menús y a los comandos, no al contenido de tus notas, que siempre es texto plano tuyo.

Ten en cuenta que la documentación oficial y buena parte de los plugins de la comunidad siguen estando solo en inglés, así que conviene familiarizarse con los términos originales: vault para la bóveda, note para la nota y backlink para el enlace entrante.

Escribir tu primera nota

Crea una nota nueva con el icono de documento del panel lateral o con el atajo de teclado correspondiente. El nombre del archivo es también el título de la nota y lo que usarás para enlazarla desde otras notas, así que conviene ponerle un nombre descriptivo.

Modo edición y modo lectura

Obsidian tiene dos formas de ver una nota: el modo edición, donde escribes el Markdown, y el modo lectura, donde ves el resultado renderizado. Puedes alternar entre ambos con Ctrl+E en Windows y Linux, o Cmd+E en macOS.

El modo edición tiene a su vez dos variantes. En la vista en vivo, el formato se aplica sobre la marcha mientras escribes y solo ves los símbolos de Markdown en la línea donde está el cursor. En la vista de código fuente, ves siempre el Markdown tal cual. La primera es más cómoda para escribir textos largos, la segunda es mejor cuando estás peleándote con la sintaxis.

La sintaxis básica

Dentro de Obsidian funciona toda la sintaxis básica de Markdown que ya conoces, sin sorpresas ni dialectos raros.

# Titulo de la nota

Un parrafo normal con **negrita**, *cursiva* y `codigo en linea`.

## Una seccion

- Un elemento de lista
- Otro elemento
  - Un elemento anidado

1. Una lista numerada
2. Su segundo elemento

> Una cita en bloque

[Un enlace externo](https://ejemplo.com)

Obsidian es compatible con CommonMark y con la mayor parte de GitHub Flavored Markdown, así que lo que escribas se verá prácticamente igual en GitHub o en cualquier otro editor.

Los enlaces internos, el corazón de Obsidian

Aquí es donde Obsidian se separa del resto de editores de Markdown. Los enlaces entre notas no son decorativos: construyen una red navegable de ida y vuelta que es la razón principal para usar la aplicación.

Enlaces con dobles corchetes

La sintaxis propia de Obsidian para enlazar una nota con otra son los dobles corchetes, heredados de las wikis.

Esta idea se relaciona con [[Aprendizaje espaciado]].

Al escribir [[ la aplicación te sugiere notas existentes. Si escribes el nombre de una nota que todavía no existe, el enlace aparece atenuado y la nota se crea en el momento en que haces clic en él. Esto permite escribir primero y organizar después, que es la forma natural de trabajar con notas.

Alias y enlaces a una sección

Puedes cambiar el texto visible del enlace con una barra vertical, y apuntar a un encabezado concreto o a un bloque con la almohadilla y el acento circunflejo.

Enlace con texto alternativo: [[Aprendizaje espaciado|repasar cada cierto tiempo]]

Enlace a una seccion: [[Aprendizaje espaciado#Ideas clave]]

Enlace a un bloque concreto: [[Aprendizaje espaciado#^bloque1]]

Enlaces Markdown estándar

Los dobles corchetes no son Markdown estándar: son una extensión de Obsidian. Si te preocupa la portabilidad de tus notas hacia otras herramientas, en los ajustes puedes desactivar los enlaces con dobles corchetes y hacer que Obsidian genere enlaces Markdown normales.

[Aprendizaje espaciado](aprendizaje-espaciado.md)

La contrapartida es que pierdes el autocompletado cómodo y la creación automática de notas. La mayoría de usuarios se quedan con los dobles corchetes, pero conviene saber que existe la alternativa si algún día quieres migrar a otra aplicación.

Enlaces entrantes

Cada nota tiene un panel de enlaces entrantes que muestra qué otras notas la mencionan. Es la mitad más valiosa del sistema: no solo ves a dónde apunta una nota, sino quién apunta a ella, y ahí es donde suelen aparecer las conexiones que no habías pensado.

Las propiedades, el front matter de Obsidian

Las propiedades de Obsidian son un bloque de front matter en YAML al principio del archivo, delimitado por tres guiones. La aplicación lo muestra como una tabla de campos editables en vez de como texto plano.

---
title: Aprendizaje espaciado
tags:
  - aprendizaje
  - memoria
fecha: 2026-01-15
estado: en progreso
aliases:
  - repeticion espaciada
---

El contenido de la nota empieza aqui.

Hay algunas propiedades con significado especial. tags añade etiquetas a la nota, aliases define nombres alternativos por los que podrás enlazarla y encontrarla en la búsqueda, y cssclasses permite aplicar estilos concretos a esa nota.

El resto de campos son libres y los puedes usar para lo que quieras. Combinados con plugins de consulta, se convierten en la base para generar índices y listados automáticos.

Cómo hacer una tabla en Obsidian

Las tablas en Obsidian se escriben con la sintaxis estándar de Markdown, usando barras verticales para separar las columnas y una línea de guiones para separar la cabecera del cuerpo.

| Concepto | Descripcion | Estado |
| --- | --- | --- |
| Enlaces internos | Conectan notas entre si | Aprendido |
| Propiedades | Metadatos en YAML | En progreso |
| Plugins | Amplian la aplicacion | Pendiente |

Puedes controlar la alineación de cada columna con dos puntos en la línea separadora.

| Izquierda | Centrado | Derecha |
| :--- | :---: | ---: |
| Texto | Texto | 100 |

No hace falta que las barras estén perfectamente alineadas en el código: Obsidian renderiza la tabla igual aunque el Markdown quede desordenado. Aun así, si quieres que el archivo sea legible fuera de la aplicación, consulta cómo formatear tablas en Markdown.

Obsidian incluye además un editor visual de tablas, que permite añadir filas y columnas con el ratón sin tocar la sintaxis. Es cómodo para tablas grandes, pero el resultado sigue siendo Markdown puro en el archivo.

Cómo mostrar código en Obsidian

Para mostrar código en Obsidian usa bloques delimitados por tres acentos graves, indicando el lenguaje justo después de los primeros tres para activar el resaltado de sintaxis.

```javascript
function saludar(nombre) {
  return `Hola, ${nombre}`;
}
```

Esto vale para cualquier lenguaje: python, bash, json, css, sql y decenas más. Si no indicas ninguno, el bloque se muestra sin colores.

Un caso que confunde a mucha gente es el HTML. Si escribes HTML directamente en la nota, Obsidian lo interpreta y lo renderiza como HTML de verdad, no lo muestra como texto. Para que el código HTML se vea como código en vez de ejecutarse, tienes que meterlo en un bloque indicando el lenguaje.

```html
<div class="aviso">
  <p>Esto se vera como codigo, no como un div renderizado</p>
</div>
```

Cómo hacer que el HTML se vea como código

Este es el caso que más problemas da. Obsidian interpreta el HTML que escribes en una nota y lo renderiza, así que si pegas una etiqueta directamente verás el resultado y no el código. La solución es siempre la misma: encerrarlo en un bloque declarando html como lenguaje.

Si además quieres mostrar en la nota un bloque de código que contenga a su vez tres acentos graves, envuelve el bloque exterior en cuatro acentos graves. Es el mismo truco que se usa para crear bloques de código en Markdown.

Para fragmentos cortos dentro de un párrafo, usa un solo acento grave a cada lado. Si el fragmento contiene acentos graves, envuélvelo en dos.

La sintaxis extra de Obsidian

Además del Markdown estándar, Obsidian añade unas cuantas extensiones propias que merece la pena conocer porque las vas a usar a diario.

Callouts o bloques de aviso

Los callouts son citas en bloque con un tipo declarado entre corchetes. Sirven para destacar avisos, notas al margen o advertencias.

> [!note] Titulo opcional
> El contenido del aviso va aqui, con el mismo formato
> que cualquier cita en bloque.

> [!warning]
> Un aviso de advertencia.

> [!tip]- Un callout plegable
> Este contenido empieza plegado por el guion tras los corchetes.

Hay varios tipos disponibles, entre ellos note, tip, info, warning, danger, success, question y quote, cada uno con su color e icono. Un signo más tras los corchetes hace el bloque plegable y abierto, y un guion lo hace plegable y cerrado. Si quieres el equivalente en otras plataformas, mira cómo mostrar advertencias en Markdown.

Insertar notas e imágenes

Anteponiendo una exclamación a un enlace interno, Obsidian inserta el contenido enlazado dentro de la nota actual en vez de solo enlazarlo.

![[Aprendizaje espaciado]]

![[Aprendizaje espaciado#Ideas clave]]

![[diagrama.png]]

![[diagrama.png|300]]

Puedes insertar notas completas, secciones concretas, imágenes, PDF y audio. El número tras la barra vertical fija el ancho en píxeles de una imagen, que es la forma de redimensionar imágenes dentro de Obsidian.

Resaltar texto

Obsidian soporta el resaltado con doble signo igual, una extensión que también existe en otras herramientas.

Esto es texto ==resaltado== dentro de un parrafo.

Es útil para marcar lo importante al procesar notas de lectura. Tienes más opciones en la guía de cómo resaltar texto en Markdown.

Listas de tareas

Las casillas de verificación funcionan con la sintaxis de GitHub y en Obsidian son clicables directamente en el modo lectura y en la vista en vivo.

- [ ] Tarea pendiente
- [x] Tarea completada
- [ ] Otra tarea pendiente

Al marcar una casilla con el ratón, Obsidian modifica el archivo .md real. Puedes ampliar esto en crear listas de tareas.

Diagramas y fórmulas

Obsidian renderiza diagramas Mermaid de forma nativa, sin instalar nada.

```mermaid
graph TD
    A[Nota fugaz] --> B[Nota permanente]
    B --> C[Articulo]
```

Y también soporta fórmulas matemáticas con sintaxis LaTeX, en línea con un signo de dólar a cada lado y en bloque con dos.

Una formula en linea: $E = mc^2$

Una formula en bloque:

$$
\int_{a}^{b} f(x)\,dx = F(b) - F(a)
$$

Organizar las notas

Obsidian ofrece tres sistemas de organización que se pueden combinar, y no hace falta elegir uno solo desde el principio.

Carpetas

El panel lateral muestra el árbol de carpetas real del disco. Funciona, pero es el método menos flexible: una nota solo puede estar en una carpeta, y muchas notas encajarían en varias a la vez.

La recomendación habitual es no obsesionarse con la jerarquía. Una estructura plana con muchos enlaces suele funcionar mejor que veinte carpetas anidadas, sobre todo si sigues el método Zettelkasten.

Etiquetas

Las etiquetas se escriben con una almohadilla delante, en cualquier punto del texto o en la propiedad tags del front matter.

Esta nota trata sobre #productividad y #escritura.

Tambien admite jerarquias: #proyecto/tutorialmarkdown

A diferencia de las carpetas, una nota puede tener todas las etiquetas que quieras, y el panel de etiquetas te deja filtrar la bóveda entera por ellas.

La vista de grafo

El grafo dibuja tus notas como nodos y los enlaces internos como aristas. Es la función más llamativa de Obsidian y la que sale en todas las capturas de pantalla.

Sé realista con ella: es útil para detectar notas huérfanas sin ningún enlace y para ver de un vistazo qué zonas de tu bóveda están más desarrolladas, pero no es una herramienta de trabajo diario. El grafo local, que muestra solo lo conectado con la nota abierta, resulta bastante más práctico.

Buscar dentro de la bóveda

Cuando la bóveda crece, la búsqueda pasa a ser la herramienta principal de navegación, por delante de las carpetas. Obsidian tiene dos formas de buscar y conviene conocer las dos.

La búsqueda rápida, con Ctrl+O, abre notas por su nombre y es la que usarás el noventa por ciento del tiempo. La búsqueda global, con Ctrl+Shift+F, recorre el contenido de todos los archivos y admite operadores para afinar los resultados.

tag:#productividad
path:proyectos/
file:reunion
line:(markdown obsidian)
["frase exacta"]
-excluir

Los operadores se pueden combinar en la misma consulta, así que tag:#proyecto path:trabajo/ -archivado devuelve las notas etiquetadas como proyecto dentro de la carpeta de trabajo que no contengan la palabra archivado. La búsqueda distingue entre buscar en la línea y buscar en el bloque, lo que cambia bastante los resultados en notas largas.

Plantillas y notas diarias

Estas dos funciones vienen incluidas en la aplicación y son las que convierten Obsidian en una herramienta de uso diario en lugar de un simple editor.

Plantillas

Activa el plugin interno de plantillas e indica una carpeta donde guardarlas. Cada plantilla es una nota Markdown normal que puedes insertar en cualquier otra nota con un comando.

---
tipo: reunion
fecha: {{date}}
asistentes:
---

# Reunion {{date}}

## Temas tratados

## Acuerdos

## Tareas pendientes

- [ ]

Obsidian sustituye {{date}}, {{time}} y {{title}} al insertar la plantilla. Si necesitas lógica más compleja, con condiciones o variables propias, el plugin de la comunidad Templater amplía bastante estas posibilidades. Tienes ejemplos listos para copiar en nuestras plantillas de Markdown, como la de notas de reunión.

Notas diarias

El plugin de notas diarias crea automáticamente una nota por cada día, con el formato de nombre y la plantilla que le indiques. Es la base del método de trabajo más extendido en Obsidian: escribes todo en la nota del día sin pensar dónde va, y luego enlazas lo que merezca la pena a notas permanentes.

Combinado con el plugin de calendario de la comunidad, obtienes una vista mensual desde la que saltar a cualquier día. Es un flujo especialmente cómodo para diarios de trabajo y registros de proyecto.

Los plugins

Buena parte de la potencia de Obsidian está en su sistema de plugins, dividido en dos grupos.

Plugins internos

Vienen con la aplicación y solo hay que activarlos en los ajustes. Algunos de los más útiles son los siguientes.

• Notas diarias: crea automáticamente una nota por día a partir de una plantilla.
• Plantillas: inserta bloques de texto predefinidos en cualquier nota.
• Búsqueda global: busca por texto, etiqueta, ruta o propiedad en toda la bóveda.
• Paleta de comandos: ejecuta cualquier acción sin tocar el ratón.
• Historial de versiones: recupera estados anteriores de una nota.

Plugins de la comunidad

Son de terceros y se instalan desde el catálogo dentro de la propia aplicación. Los más extendidos son Dataview, que permite generar listados y tablas consultando las propiedades de tus notas como si fueran una base de datos, Templater, que amplía las plantillas con lógica y variables, Calendar, que añade una vista de calendario sobre las notas diarias, y Git, que versiona la bóveda automáticamente en un repositorio.

Un aviso práctico: es muy fácil pasarse instalando plugins y acabar dedicando más tiempo a configurar el sistema que a escribir notas. Empieza sin ninguno y añade solo el que resuelva un problema que ya tengas. Puedes consultar el catálogo completo en la página oficial de plugins.

Personalizar la apariencia

Obsidian permite cambiar el aspecto de la aplicación en tres niveles distintos, de menos a más control.

• Temas: hay un catálogo de temas de la comunidad que se instalan desde los propios ajustes y cambian toda la interfaz de golpe.
• Fragmentos CSS: puedes colocar archivos .css en la carpeta .obsidian/snippets de la bóveda y activarlos individualmente para retocar detalles concretos.
• Propiedad cssclasses: aplicando esta propiedad en el front matter de una nota, los estilos afectan solo a esa nota, algo útil para notas que necesitan un formato especial.

Como la configuración vive dentro de la bóveda, si sincronizas la carpeta te llevas la apariencia a todos tus dispositivos sin repetir el trabajo.

Importar notas desde otras aplicaciones

Obsidian incluye un plugin interno de importación que convierte notas de otras herramientas a archivos Markdown dentro de tu bóveda. Admite formatos habituales como Notion, Evernote, Apple Notes, Bear, Roam y HTML genérico, aunque la lista cambia con las versiones, así que conviene revisar la documentación oficial para ver los formatos soportados en cada momento.

La importación nunca es perfecta. Los elementos que no existen en Markdown, como las bases de datos de Notion o los bloques anidados, se convierten en aproximaciones y casi siempre hay que repasar el resultado a mano. Si vienes de Notion, tenemos una guía específica sobre cómo migrar de Notion a Obsidian sin perder formato.

También puedes importar sin plugin: como la bóveda es una carpeta normal, basta con copiar dentro cualquier conjunto de archivos .md y Obsidian los indexará al instante. Si tus documentos están en otro formato, puedes pasarlos antes por nuestro conversor de HTML a Markdown.

Exportar y publicar tus notas

Tus notas ya son archivos Markdown portables, así que exportar suele significar convertirlas a un formato para compartir con alguien que no usa Obsidian.

• PDF: la aplicación exporta cualquier nota a PDF directamente, respetando el tema visual activo. También puedes usar nuestro conversor de Markdown a PDF.
• Word y HTML: copia el contenido del archivo y pásalo por los conversores de Markdown a DOCX o de Markdown a HTML.
• Presentaciones: Obsidian tiene un modo de presentación que divide la nota en diapositivas usando líneas horizontales como separador, el mismo principio que explicamos en Markdown a diapositivas.
• Obsidian Publish: el servicio oficial de pago que publica una bóveda o parte de ella como sitio web con los enlaces internos funcionando.

Si lo que quieres es montar un sitio propio a partir de tus notas, también puedes apuntar un generador estático a la carpeta de la bóveda, como se explica en cómo crear un blog con Markdown.

Sincronizar las notas entre dispositivos

Como la bóveda es una carpeta normal, tienes varias formas de sincronizarla y ninguna es obligatoria.

• Obsidian Sync: el servicio oficial de pago, cifrado de extremo a extremo y el que mejor gestiona los conflictos entre dispositivos.
• Git: versiona la bóveda en un repositorio, con historial completo de cada cambio. Es la opción preferida por desarrolladores y permite acceder a las notas desde aplicaciones como GitJournal o desde la terminal.
• Carpeta en la nube: colocar la bóveda dentro de Dropbox, Google Drive o iCloud funciona, pero conviene evitar editar la misma nota en dos dispositivos a la vez porque estos servicios resuelven mal los conflictos de archivos de texto.

Consulta la documentación oficial para las condiciones y límites actuales de cada opción.

Obsidian en el móvil

Las aplicaciones de Android e iOS abren la misma bóveda y comparten configuración y plugins con la versión de escritorio, siempre que tengas la sincronización resuelta. La experiencia de escritura es razonable, pero el móvil se usa sobre todo para capturar ideas rápidas y consultar notas, no para sesiones largas.

La barra de herramientas móvil es configurable y conviene dedicarle cinco minutos: dejar a mano los dobles corchetes, las casillas de tarea y el encabezado ahorra mucho tiempo en una pantalla táctil. Ten en cuenta también que algunos plugins de la comunidad no son compatibles con móvil, y el catálogo lo indica en cada ficha.

Atajos de teclado útiles

Estos son los atajos que más vas a usar en el día a día. En macOS se sustituye Ctrl por Cmd.

Todos son configurables desde los ajustes, y la paleta de comandos te permite ejecutar cualquier acción escribiendo su nombre aunque no tenga atajo asignado.

Errores comunes al empezar

Estos son los tropiezos que más se repiten entre quienes llegan nuevos a la aplicación.

• Montar la estructura antes de tener notas: no diseñes veinte carpetas el primer día. Escribe treinta notas y observa qué estructura pide el contenido.
• No enlazar nada: una bóveda sin enlaces internos es una carpeta de archivos de texto. El valor de Obsidian aparece cuando las notas se conectan entre sí.
• Instalar diez plugins de golpe: configurar el sistema perfecto es una forma muy efectiva de no escribir nunca.
• Poner la bóveda dentro de una carpeta sincronizada y editar a la vez en dos sitios: es la vía rápida a los archivos duplicados con sufijo de conflicto.
• Usar rutas absolutas en las imágenes: si mueves la bóveda, todo se rompe. Deja que Obsidian gestione las rutas relativas.

Preguntas frecuentes

Estas son las dudas que más se repiten entre quienes empiezan con la aplicación.

¿Obsidian es gratis? Es gratuito para uso personal, sin límite de notas ni de dispositivos. Los servicios de pago son opcionales y cubren la sincronización oficial y la publicación web. El uso comercial tiene su propia licencia. Consulta la web oficial para las condiciones vigentes.

¿Necesito conexión a internet? No. Obsidian funciona en local sobre archivos de tu disco, así que puedes trabajar sin conexión de principio a fin.

¿Qué pasa con mis notas si Obsidian desaparece? Nada. Tus notas son archivos .md en una carpeta tuya y los puedes abrir con cualquier editor de texto o con cualquier otra aplicación de Markdown. Esta es la principal ventaja del formato frente a las herramientas con base de datos propietaria.

¿Obsidian usa Markdown estándar? En su mayor parte sí, con extensiones propias como los enlaces con dobles corchetes, los embeds y los callouts. Esas extensiones no se verán igual fuera de Obsidian, aunque el archivo sigue siendo legible.

¿Cuántas notas aguanta una bóveda? Miles sin problema. El rendimiento empieza a notarse con bóvedas muy grandes y muchos plugins activos, no por el número de notas en sí.

¿Puedo usar la misma bóveda en varios ordenadores? Sí, mediante cualquiera de los métodos de sincronización descritos más arriba. Lo único que hay que evitar es editar la misma nota a la vez en dos sitios con una carpeta de nube genérica.

Siguientes pasos

Con lo anterior ya puedes trabajar con Obsidian a diario. A partir de aquí puedes seguir por varios caminos:

• Consultar la guía de soporte Markdown de Obsidian para ver al detalle qué sintaxis admite la aplicación
• Aplicar el método Zettelkasten para que tu red de notas crezca con criterio
• Repasar la sintaxis básica y la sintaxis extendida de Markdown
• Comparar Obsidian con otras opciones como Logseq, Joplin o Notion
• Ver las plantillas de Markdown listas para usar dentro de tus notas