abril de 2026
obsidian-notes — Publicar desde Obsidian
Pipeline que convierte notas marcadas de una bóveda de Obsidian en un sitio web: transforma wikilinks, renderiza código y matemática, y deploya en Netlify.
- React
- Vite
- React Router
- react-markdown
- KaTeX
- highlight.js
- Bash
- Netlify
obsidian-notes publica como sitio web las notas que yo elijo de una bóveda de Obsidian — un digital garden. Marco una nota con publish: true en el frontmatter y aparece online; el resto queda privado.
Cómo funciona
sync-notes.shlee la bóveda (VAULT_PATH), busca los.mdconpublish: truey copia esas notas y sus imágenes al proyecto.- En el build, Vite importa todas las notas con
import.meta.glob. NoteRenderertraduce los wikilinks de Obsidian —[[Nota]]a links de React Router y![[img.png]]a<img>— antes de pasar el markdown a react-markdown.- Renderizado rico: GFM, código con highlight.js y matemática con KaTeX (rehype/remark).
Cómo está hecho
- React + Vite + React Router (SPA estática). Slugs consistentes con
github-slugger. - Deploy en Netlify: el build corre
sync-notes.sh && vite build. Si la bóveda vive en un repo privado, se clona en el build con un token — el contenido nunca se commitea al repo público. - Cero servidor propio: es 100% estático.