Markdown + Obsidian: el flujo perfecto para escribir contenido

Escritorio oscuro con portátil, bolígrafo y cuaderno
Fotografía de 2H Media · Unsplash (licencia gratuita). Un flujo de notas entre papel y edición digital. · Ver imagen original

Mi obsesión con los flujos de escritura viene de lejos. He probado Bear, Notion, iA Writer, Ulysses, Logseq,VSCode con plugins… y siempre volvía a algo fundamental: mi texto terminaba encerrado en una base de datos propietaria de la que era difícil extraerlo sin perder formato.

Ilustración conceptual de flujo editorial en Markdown y Obsidian: notas, colecciones y publicación.
Ilustración conceptual original: síntesis visual del tema del artículo, no captura ni prueba ejecutada.

Por qué Markdown

Markdown es texto plano. Va a sobrevivir a cualquier app que uses hoy. Va a sobrevivir a ti. Si dentro de diez años quieres abrir un artículo que escribiste hoy, lo podrás leer con cat desde cualquier terminal. No necesitas un SDK, no necesitas una API, no necesitas permisos.

Obsidian es un editor Markdown local, con carpeta de bóveda (vault) que es literalmente un directorio del sistema de archivos. Eso significa que puedo apuntar mi proyecto Astro a esa carpeta y publicar sin intermediarios.

El setup

Mi estructura actual:

~/Documents/obsidian/blog/
├── por-que-elegi-astro.md
├── markdown-obsidian-flujo.md   ← este artículo
├── tailwind-sin-css.md
└── islas-svelte-astro.md

Y en el proyecto Astro:

src/content/blog/  ← symlink a la carpeta del Obsidian
src/content/config.ts  ← schema Zod

Con un symlink de src/content/blog/ hacia ~/Documents/obsidian/blog/, escribir en Obsidian y verlo reflejado en astro dev es inmediato. No hay paso de “publicar”, no hay API. Solo guardas y recargas.

Frontmatter tipado

El schema Zod que define mi colección exige title, pubDate y permite tags, description, draft. Si escribo mal un campo en Obsidian (olvido la fecha, pongo un string donde iba un booleano), Astro me da un error en consola antes de llegar al navegador:

---
title: "Mi artículo"
pubDate: 2025-09-10
tags: ["markdown", "obsidian"]
draft: false
---

Drafts: posts en progreso sin romper el build

El campo draft: true me permite dejar artículos a medio escribir dentro de la misma bóveda. Mi helper getPublishedPosts() filtra los drafts:

const posts = await getCollection('blog', ({ data }) => !data.draft);

Así puedo guardar el progreso, cerrar Obsidian, y el blog en producción sigue mostrando solo lo terminado.

Sincronización entre dispositivos

Con Obsidian Sync (o iCloud, o git, lo que prefieras) el vault viaja entre mi laptop y mi móvil. Puedo empezar un artículo en el metro y terminarlo en casa. Todo en Markdown plano, todo versionable, todo mío.

Conclusión

Markdown + Obsidian + Astro es el flujo más sostenible que he encontrado para escribir en internet. El contenido vive en texto plano, el editor es local y rápido, el sitio es estático y barato de hostear. Si te importa la longevidad de lo que escribes, este es el camino.