Visión general, stack tecnológico, flujo de alto nivel, Hermes Agent y estructura del sistema MarkeUP.
Admin 15 de junio de 2026, 00:00 6 min de lectura
Tabla de Contenidos 15 secciones
MarkeUP es un sistema de publicación multiblog que convierte un vault de Obsidian en un sitio web estático moderno. El contenido se escribe en Markdown dentro de Obsidian, se sincroniza al ordenador de build vía Syncthing, y se despliega en Cloudflare Pages mediante GitHub Actions. Además, integra Hermes Agent — un asistente de IA local (vía Ollama) que gestiona, crea, amplía y enriquece el vault de forma inteligente.
“En el móvil escribes, el Mac/PC construye, la nube sirve, y Hermes gestiona.”
| Capa | Tecnología | Propósito |
|---|---|---|
| Framework | Astro 4.16 | Generación de sitio estático (SSG) |
| CSS | TailwindCSS 3 + DaisyUI 4 | Componentes UI + 6 temas |
| Búsqueda | Pagefind 1.5 | Búsqueda full-text offline |
| Grafo 3D | Three.js + 3d-force-graph | Visualización interactiva |
| Grafo 2D | D3.js | Grafo de relaciones alternativo |
| Imágenes | Sharp 0.33 | Crop + WebP responsivo |
| Smooth Scroll | Lenis 1.3 | Scroll suave táctil |
| Markdown | remark + rehype | Wikilinks `[[slug |
| Gestión IA | Hermes Agent v0.18.2 | Editor Jefe del vault: crear, ampliar, auditar, wikilinks |
| Motor LLM | Ollama + qwen2.5-coder:7b-64k | Inferencia local de lenguaje |
| Sincronización | Syncthing | Peer-to-peer Móvil ↔ Mac |
| CI/CD | GitHub Actions | Build + deploy automático |
| Hosting | Cloudflare Pages | CDN global |
markeup/
├── src/
│ ├── generar_articulo.py ← Script: posts automáticos desde URLs con Ollama
│ ├── telegram_bot.py ← Bot de Telegram
│ ├── components/ ← 18 componentes Astro (blog/, common/, graph/)
│ ├── content/
│ │ ├── posts/ ← Colección de 63 posts en 5 categorías
│ │ │ ├── Biodanza/ ← 34 posts (bienestar, energía, filosofía)
│ │ │ ├── Documentación/ ← 5 docs del sistema
│ │ │ ├── Literatura/ ← 2 posts (Pessoa)
│ │ │ ├── Opinión/ ← 1 post
│ │ │ ├── Tecnología/ ← 21 posts (dev, IA, herramientas)
│ │ │ ├── img/ ← Imágenes fuente
│ │ │ └── hermes/ ← 🆕 Sistema de gestión IA del vault
│ │ │ ├── SOUL.md ← Personalidad y reglas de Hermes
│ │ │ ├── memory/ ← vault-index, conventions, backlog
│ │ │ ├── skills/ ← crear, ampliar, wikilinks, auditar
│ │ │ ├── templates/ ← Plantilla de frontmatter (21 campos)
│ │ │ ├── rules/ ← Especificaciones YAML, wikilinks, estilo
│ │ │ └── logs/ ← Registro de sesiones
│ │ └── content.config.ts ← Schema Zod + loader glob
│ ├── layouts/BaseLayout.astro ← Layout único: OG tags, Breadcrumb, Lenis
│ ├── lib/ ← posts.ts, tags.ts, graph.ts, images.ts, remark-wikilink.js
│ ├── pages/ ← 16+ rutas (index, posts, category, tags, graph, search)
│ └── styles/ ← CSS modular (@layer base/components/utilities)
├── scripts/ ← process-images, optimize, sync, compress-audio, dev-search
├── public/ ← img (WebP), fonts, audpublic, pagefind
├── astro.config.mjs ← site, aliases, remark-wikilink, rehype-slug
├── tailwind.config.cjs ← DaisyUI 6 temas, typography
└── .github/workflows/ ← deploy.yml + lighthouse.yml
Hermes Agent es un asistente de IA que corre localmente sobre Ollama y gestiona el vault de forma inteligente:
| Función | Descripción |
|---|---|
| Crear posts | Genera notas con frontmatter YAML completo (21 campos), wikilinks inteligentes y estructura consistente |
| Ampliar posts | Expande contenido existente manteniendo tono y estilo |
| Gestionar wikilinks | Escanea notas, detecta conceptos enlazables, genera `[[slug |
| Auditar vault | Detecta huérfanos, inconsistencias, tags duplicados, sugiere mejoras |
| Mantener índice | memory/vault-index.md actualizado con 63 slugs, ~150 tags, ~100 huérfanos |
| Backlog | 22 ideas de posts priorizadas por demanda (huérfanos con más apariciones) |
hermes/
├── SOUL.md ← Personalidad: Editor Jefe, protocolo, reglas
├── memory/
│ ├── vault-index.md ← Índice vivo de TODOS los slugs, tags, huérfanos
│ ├── conventions.md ← Decisiones editoriales + correcciones pendientes
│ └── backlog.md ← 22 ideas priorizadas de posts a crear
├── skills/ ← Flujos de trabajo detallados
│ ├── crear-post.md ← 11 pasos: desde tema hasta backlinks
│ ├── ampliar-post.md ← Expansión de notas existentes
│ ├── generar-wikilinks.md ← Escaneo inteligente + diffs
│ ├── auditar-vault.md ← Auditoría completa con informe
│ └── documentar.md ← 🆕 Verifica que la doc refleje la realidad
├── templates/
│ └── post-template.md ← Plantilla YAML con 21 variables
├── rules/
│ ├── frontmatter-spec.md ← Especificación de cada campo
│ ├── wikilinks-spec.md ← Reglas de [[sintaxis|alias]]
│ └── style-guide.md ← Tono, estructura, formato, SEO
└── logs/sessions/ ← Trazabilidad de cada acción
# Iniciar Hermes (requiere Ollama corriendo)
hermes chat
# Ejemplos de comandos:
# "Crea un post sobre meditación vipassana en categoría Biodanza"
# "Amplía el-grounding.md con una sección sobre técnicas de enraizamiento"
# "Revisa los wikilinks de el-aura.md"
# "Audita el vault"
# "¿Qué posts debería crear primero?" → consulta el backlog
- 🆕 Editor Jefe IA con SOUL, reglas, skills y memoria persistente
- 🆕 Índice automático del vault (63 slugs, ~150 tags, ~100 huérfanos)
- 🆕 Backlog de 22 ideas de posts priorizadas
- 🆕 Protocolo LEER → ANALIZAR → PROPONER → CONFIRMAR → ESCRIBIR → LOGUEAR → INDEXAR
- BreadcrumbList JSON-LD, Open Graph completo, Twitter Cards, sitemap, RSS
- Imágenes responsivas (srcset 640w-1920w), preload LCP, font-display swap, CSS @layer
- 6 temas DaisyUI, glassmorphism, Lenis smooth scroll, grafos 3D/2D, Pagefind search
- 63 posts en 5 categorías
- Wikilinks
[[slug]]y[[slug|alias descriptivo]] - Frontmatter YAML de 21 campos validado con Zod
| Documento | Contenido |
|---|---|
| doc-guia | Instalación y configuración (Syncthing, Obsidian, Templater, Ollama) |
| doc-arquitectura | Arquitectura: árbol de archivos, flujo de build, componentes, CSS, CI/CD |
| doc-operacion | Comandos, scripts, troubleshooting, Hermes Agent |
| doc-auditoria | Estado actual, deuda técnica, plan de mejoras, métricas |
1 PROCESOS
├── 1.1 PROCESOS OLLAMA (iniciar, cambiar modelo, estado, detener)
├── 1.2 PROCESOS TELEGRAM (iniciar/detener bot)
├── 1.3 PROCESOS HERMES (lanzar, reanudar, cambiar modelo)
└── 1.4 ARRANCAR Ollama + Telegram
2 VAULT → 2.1 ANÁLISIS DEL VAULT (auditar, huérfanos, stats, docs...)
3 CONTENIDO DEL VAULT (crear, generar artículo, ampliar, wikilinks...)
4 BUILD & ASSETS
├── 4.1 PROCESAR IMÁGENES Y AUDIOS
├── 4.2 BUILD (completo, preview, pagefind)
├── 4.3 DEV SERVER (local, network)
└── 4.4 NPM (8 comandos útiles)
5 GIT
├── 5.1 Ramas (creación y cambio)
├── 5.2 Ramas (limpieza y fusión)
├── 5.3 Estado y preparación
├── 5.4 Commits y deshacer
├── 5.5 Stash
└── 5.6 Remoto
6 CLOUDFLARE
├── 6.1 Autenticación y proyectos
└── 6.2 Despliegues (preview, producción, rama)
7 MANTENIMIENTO (renombrar, mover, limpiar, exportar, docs)
8 STATUS (posts, git, build, Ollama, assets)