44. Bases de conocimiento personal {#44-bases-de-conocimiento-personal}

Markdown es la base de muchas herramientas de gestión del conocimiento personal (PKM): Obsidian, Logseq, Foam, Zettlr o Joplin. La promesa es atractiva: notas en texto plano, enlazadas entre sí, sin depender de una base de datos propietaria. La realidad incluye extensiones y convenciones que conviene conocer para no perder portabilidad.

44.1 Por qué Markdown {#441-por-qué-markdown}

• Texto plano: legible dentro de décadas.
• Portable: se abre con cualquier editor.
• Versionable: Git y diffs legibles.
• Enlazable: cada nota es un archivo con una ruta estable.
• Extensible: metadatos, enlaces wiki, plugins.

El riesgo es adoptar sintaxis que solo entiende una aplicación. Cuanto más cerca esté la nota de Markdown estándar, más fácil será migrarla.

44.2 Obsidian {#442-obsidian}

Obsidian trabaja sobre una bóveda (una carpeta con archivos .md).

---
title: "Markdown"
tags: [markdown, documentación]
aliases: [MD]
created: 2026-10-28
---

# Markdown

Enlaza con [[CommonMark]] y [[GFM]].

> [!warning] Compatibilidad
> Los enlaces wiki no son Markdown estándar.

• Obsidian: https://obsidian.md/
• Documentación: https://help.obsidian.md/

44.2.1 Plugins y funciones no portables {#4421-plugins-y-funciones-no-portables}

• Dataview: consultas sobre el Front Matter; no funciona fuera de Obsidian.
• Templater: plantillas con lógica.
• Canvas: tableros en JSON.
• Graph view: visualización de enlaces.
• Publish/Sync: servicios de pago.

Los plugins pueden ejecutar código y acceder a la bóveda: instala solo los que conozcas y revisa sus permisos.

44.3 Logseq {#443-logseq}

Logseq es un outliner basado en bloques y diarios.

• [[página]] crea enlaces.
• ((referencia)) enlaza bloques.
• TODO, DOING, DONE gestionan tareas.
• Las consultas (query) filtran bloques.
• Los diarios (journals/) organizan por fecha.

- Idea principal
  - Detalle con enlace a [[Markdown]]
  - Tarea TODO revisar #documentación

• Logseq: https://logseq.com/

Ventaja: captura rápida y pensamiento no lineal. Limitación: la estructura de bloques y las consultas no son Markdown estándar.

44.4 Otras herramientas {#444-otras-herramientas}

• Foam: https://foambubble.github.io/foam/
• Zettlr: https://www.zettlr.com/
• Joplin: https://joplinapp.org/

44.5 Método Zettelkasten {#445-método-zettelkasten}

Principios que encajan bien con Markdown:

1. Notas atómicas: una idea por nota.
2. Identificadores estables: nombre o fecha (202610281200 Idea).
3. Enlaces explícitos: explica por qué se enlazan dos notas.
4. Notas de índice (MOC): mapas de contenido que agrupan temas.
5. Revisión: las notas se refinan con el tiempo.
6. Referencias: cita la fuente y guarda la fecha de lectura.

La estructura de carpetas importa menos que los enlaces y la disciplina de revisión.

44.6 Front Matter para notas {#446-front-matter-para-notas}

---
title: "CommonMark"
aliases: [CommonMark, especificación CommonMark]
tags: [markdown, estándares]
status: evergreen
created: 2026-10-28
updated: 2026-10-28
source: "https://spec.commonmark.org/"
---

• title: título legible.
• aliases: variantes para enlaces.
• tags: clasificación.
• status: seed, growing, evergreen.
• created / updated: fechas ISO 8601.
• source: procedencia.

Mantén las claves en minúsculas y sé consistente: las consultas y plantillas dependen de ello.

44.7 Enlaces wiki frente a enlaces estándar {#447-enlaces-wiki-frente-a-enlaces-estándar}

Para publicar fuera de la herramienta, convierte los enlaces wiki:

obsidian-export boveda salida

• obsidian-export: https://github.com/zoni/obsidian-export

44.8 Publicar una base de conocimiento {#448-publicar-una-base-de-conocimiento}

• Quartz: https://quartz.jzhao.xyz/

Antes de publicar, revisa enlaces privados, nombres de clientes, rutas locales y metadatos personales.

44.9 Sincronización y copias {#449-sincronización-y-copias}

• Git: historial y diffs; ideal para texto, pero requiere disciplina.
• Syncthing: sincronización entre dispositivos: https://syncthing.net/.
• Nube: cómoda, pero puede generar conflictos si se edita sin conexión.
• Copias de seguridad: no confundas sincronización con respaldo.

En Git, excluye archivos de estado y caché:

.obsidian/workspace.json
.obsidian/cache
.trash/

44.10 Callouts entre plataformas {#4410-callouts-entre-plataformas}

No hay un estándar común. Si el documento va a vivir en varias plataformas, usa una cita normal (>) o una tabla, que funcionan en todas.

44.11 Accesibilidad y privacidad {#4411-accesibilidad-y-privacidad}

• Usa encabezados jerárquicos, no negritas como títulos.
• Escribe texto alternativo en las imágenes.
• Evita enlaces con texto vacío o “aquí”.
• Revisa que los plugins no envíen datos a servicios externos.
• Cifra las notas sensibles o guárdalas en un almacén aparte.

44.12 Lista de comprobación {#4412-lista-de-comprobación}

• Las notas son archivos .md legibles sin la aplicación.
• Los enlaces wiki tienen equivalente estándar o se convierten al publicar.
• El Front Matter es consistente.
• Hay copias de seguridad además de la sincronización.
• Los plugins están revisados y actualizados.
• La publicación no expone información privada.