Mis notas de Obsidian en el celular: Quartz + Cloudflare Workers + Access
Cómo convertí mi vault de Obsidian en un sitio web privado, protegido con Zero Trust y que se actualiza solo cada vez que escribo.
El problema
Tomo todas mis notas en Obsidian: clases, apuntes de ciberseguridad, redes, borradores del blog. El vault vive en GitHub, pero cuando quería consultar algo rápido desde el celular no tenía una buena opción:
- La app de GitHub muestra el Markdown, pero no entiende los
[[wikilinks]]ni las imágenes embebidas de Obsidian. - Obsidian móvil con el plugin Git funciona, pero es lento y es más de lo que necesito si solo quiero leer.
Lo que quería era abrir una URL en el teléfono y tener mis notas con buscador, enlaces entre notas y explorador de carpetas. Y, por supuesto, que nadie más pudiera verlas.
La solución
- Quartz v5: un generador de sitios estáticos pensado para notas de Obsidian. Convierte el vault en un sitio web con wikilinks, backlinks, búsqueda y grafo.
- Cloudflare Workers: hospeda el sitio y lo reconstruye automáticamente.
- Cloudflare Access (Zero Trust): pone un login delante del sitio. Solo entra mi correo.
- Dos repositorios en GitHub: uno con las notas y otro con Quartz.
- Deploy Hook + webhook de GitHub: cada push al vault dispara un nuevo build.
flowchart LR
A[Obsidian] -->|auto commit| B[(Repo notes<br/>privado)]
B -->|webhook| C[Deploy Hook]
C --> D[Workers Builds]
E[(Repo notes-web<br/>Quartz)] --> D
D -->|clona notes con token<br/>de solo lectura| D
D --> F[Worker con el sitio]
G[Celular] --> H[Cloudflare Access] --> F
El flujo final: escribo en Obsidian → auto commit → push → Cloudflare reconstruye → lo leo en el celular.
¿Por qué dos repos?
Podría haber metido las notas dentro de la carpeta content/ de Quartz y tener un solo repo, que es más fácil de montar. Preferí separarlos:
| Repo | Contenido |
|---|---|
notes (privado) |
Solo el vault. Es lo que sincroniza Obsidian. |
notes-web |
Solo Quartz: configuración y tema. Ninguna nota. |
| Link del repo notes-web https://github.com/StevenQuintanaGT/notes-web |
Así el vault queda limpio (sin node_modules ni código de Quartz). Si algún día quiero editar desde el celular con el plugin Git, solo clono mis notas. En cada build, Cloudflare descarga Quartz y le mete una copia del vault en content/.
Paso 1: El vault en GitHub con commits automáticos
Creé un repo privado y vacío, y subí el vault:
cd ruta/a/mi/vault
git init
git branch -M main
git add .
git commit -m "primer commit del vault"
git remote add origin https://github.com/TU_USUARIO/notes.git
git push -u origin main
Antes del primer commit agregué un .gitignore para no subir archivos que cambian con cada uso y generan conflictos entre dispositivos:
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.trash/
Para los commits automáticos usé el plugin Obsidian Git:
- Auto commit-and-sync interval: 10 minutos.
- Auto pull on startup: activado, para no generar conflictos si edito desde otro dispositivo.
- Commit message:
vault backup: {{date}}.
Paso 2: Quartz en local
Quartz v5 necesita Node 22 o superior. En una carpeta fuera del vault:
git clone https://github.com/jackyzha0/quartz.git notes-web
cd notes-web
npm i
npx quartz create
El asistente de create me preguntó:
- Plantilla: Obsidian.
- Contenido: Symlink an existing folder, apuntando a mi vault. Así puedo previsualizar sin copiar nada.
- Base URL: el dominio donde lo iba a publicar, sin
https://(por ejemplonotas.tudominio.com).
Para previsualizar:
npx quartz build --serve
y abrir http://localhost:8080.

Otros ajustes en quartz.config.yaml:
pageTitle: el título del sitio (por defecto dice “Quartz 5”).ignorePatterns: agreguéTemplatespara no publicar mis plantillas. Además, sus variables tipo{{date}}generaban advertencias de fecha inválida.
Paso 3: Subir Quartz a mi propio repo (y casi subo mis notas)
npx quartz create ya había configurado los remotos origin y upstream, así que solo cambié origin a mi repo:
git remote set-url origin git@github.com:TU_USUARIO/notes-web.git
git remote -v
Mi .gitignore tenía que excluir la carpeta content, que es el symlink al vault. Pero escribí .content/ (con punto) en lugar de content. Al correr git status antes del commit, aparecieron todas mis notas e imágenes listas para subirse.
Lo arreglé así:
# corregir .gitignore: "content" en lugar de ".content/"
git rm -r --cached content # --cached: solo las saca del índice, no borra nada del disco
git add .
git status
Esta vez solo aparecían archivos de Quartz (.gitignore, package.json, quartz.config.yaml…) y un deleted: content/.gitkeep. Esa eliminación es necesaria: deja la carpeta libre para que Cloudflare clone ahí el vault.
git commit -m "configuración de Quartz"
git push -u origin v5
La rama se llama v5, no main. La dejé así para que sea fácil traer actualizaciones del repo oficial.
Paso 4: Cloudflare Workers
Cloudflare ahora crea un Worker en lugar de un proyecto de Pages para sitios estáticos. Funciona igual, pero necesita un archivo wrangler.jsonc en la raíz de notes-web para saber qué carpeta servir:
{
"name": "notes-web",
"compatibility_date": "2026-11-01",
"workers_dev": false,
"preview_urls": false,
"assets": {
"directory": "./public",
"not_found_handling": "404-page"
}
}
Configuración del build (Settings → Build):
- Build command:
git clone --depth 1 https://x-access-token:$GH_TOKEN@github.com/TU_USUARIO/notes.git content && npx quartz plugin install && npx quartz build - Deploy command:
npx wrangler deploy - Build variables:
NODE_VERSION = 24y, más adelante,GH_TOKENcomo secreto.
Además, desactivé la URL *.workers.dev y las Preview URLs. El sitio solo existe en mi dominio personalizado, que es el único que protejo con Access. Es más simple y más seguro que proteger varias URLs.
Paso 5: Cloudflare Access
En Zero Trust → Access → Applications creé una aplicación Self-hosted:
- Destino: el hostname público
notas.tudominio.com. También agregué el Worker como destino, por si algún día se reactiva la URLworkers.devpor error. - Política:
Allow, incluyendo solo mi correo. - Sesión: larga (1 mes), para que el celular no pida código a cada rato.
- Login: One-time PIN, un código que llega al correo.

Probé en incógnito: aparece la pantalla de Cloudflare Access pidiendo autenticación antes de mostrar nada.

Paso 6: Token de GitHub de solo lectura
El build necesita leer el repo privado del vault. Creé un fine-grained personal access token (en la cuenta, no en el repo: Settings → Developer settings → Personal access tokens → Fine-grained tokens):
- Repository access: solo el repo
notes. - Permissions → Contents: Read-only.
- Expiration: 1 año, con un recordatorio para renovarlo.

Lo guardé en Cloudflare como build variable secreta GH_TOKEN.

Paso 7: Rebuild automático con Deploy Hook
Al principio hice push al vault y Cloudflare no hizo nada. Tiene sentido: el Worker vigila el repo notes-web, no el de las notas.
La solución fueron los Deploy Hooks de Workers Builds: una URL que dispara un build cuando recibe un POST.
- En el Worker: Settings → Builds → Deploy Hooks, rama
v5. Copié la URL.

- En el repo
notes: Settings → Webhooks → Add webhook, con la URL del hook,application/jsony solo el evento push.

Ahora cada push del vault, manual o del auto commit, genera un build nuevo, y en un par de minutos el cambio está en el sitio.
Resumen de problemas
| Problema | Causa | Solución |
|---|---|---|
| Theme “default” could not be loaded | El tema se instaló durante el build | Volver a correr el build / npm i @quartz-themes/default |
| 404 en la portada | No existía index.md |
Crear index.md en la raíz del vault |
| 404 en la portada ya publicada | index.md solo con frontmatter, Quartz lo descartó |
Agregar contenido debajo del frontmatter |
| Advertencia de fecha inválida | Plantillas con {{date}} |
Excluir Templates en ignorePatterns |
Las notas aparecían en git status |
Typo en .gitignore (.content/) |
Corregir a content + git rm -r --cached content |
remote origin already exists |
Quartz ya creó los remotos | git remote set-url origin ... |
src refspec main does not match any |
La rama se llama v5 |
git push -u origin v5 |
could not read Password |
Token no disponible o sin acceso | Build variable secreta + formato x-access-token |
wrangler deploy reactiva workers.dev |
Wrangler usa workers_dev: true por defecto |
workers_dev: false y preview_urls: false en wrangler.jsonc |
| Push al vault no dispara build | El Worker vigila otro repo | Deploy Hook + webhook de GitHub |
Lo que me llevo
- Separar contenido y presentación (dos repos) complica un poco el montaje, pero deja todo más ordenado.
- Zero Trust no es solo para empresas. Con el plan gratuito de Cloudflare Access protegí un sitio personal en unos minutos, sin VPN ni servidor propio.
- Mínimo privilegio en todo: token de solo lectura limitado a un repo, política de Access con un solo correo, URLs públicas desactivadas.
- Secuencia segura: primero el control de acceso, después el contenido. El build que falla a propósito es un truco simple que evita exponer datos aunque sea por unos minutos.
- Revisar antes de commitear. Un punto de más en el
.gitignorecasi publica todas mis notas en un repo.
