# Obsidian Markdown > Explica, redacta o valida la sintaxis de Obsidian Flavored Markdown: propiedades, wikilinks, embeds, callouts, tags, comentarios, resaltados, referencias de bloque, matemáticas y Mermaid. Fuente: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-markdown Markdown: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-markdown.md Repositorio: https://github.com/AgriciDaniel/claude-obsidian Autor: AgriciDaniel Licencia: MIT Actualizado: el mes pasado Coste de contexto: 75 tok instalada, 1.1k tok al activarse, 1.1k tok con todos los archivos del bundle Bundle: 1 archivo, 4 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent claude-code # Cursor npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent cursor # Codex npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent codex # Gemini CLI npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent gemini # Windsurf npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent windsurf # Cline npx -y skills add AgriciDaniel/claude-obsidian --skill obsidian-markdown --agent cline ``` ## Qué hace - Explica, redacta y valida la sintaxis de Obsidian Flavored Markdown: propiedades, wikilinks, embeds, callouts, tags, comentarios, resaltados y bloques Mermaid - Responde preguntas de sintaxis en modo solo lectura sin tocar el vault - Si se pide editar una nota, la redacta completa y la empaqueta en una transacción `claude-obsidian.transaction.v1` con solo objetivos `wiki/` - Valida el bloque YAML, enlaces internos, referencias de bloque y balance de fences y callouts antes de aplicar ## Cuándo usarla - El usuario pide explícitamente ayuda con formato o sintaxis de notas de Obsidian - Se necesita redactar o validar una nota con propiedades YAML, wikilinks, callouts u otra sintaxis propia de Obsidian ## Cuándo no - No es para Markdown general ni para operaciones amplias sobre el vault ## Qué la activa - "¿Cómo escribo un callout de advertencia en Obsidian?" - "Valida el frontmatter de esta nota" - "Crea una nota con wikilinks y bloques de Mermaid" ## Antes de instalar - Necesita el core `claude-obsidian.py` instalado y un vault de Obsidian resuelto. - Necesita en el PATH: python3 - Variables de entorno: APPROVAL_SHA256, BUNDLE, CORE, PRODUCT_ROOT, VAULT - reads environment config ## Archivos - SKILL.md — 4 KB ## SKILL.md Reproducido tal cual desde AgriciDaniel/claude-obsidian bajo MIT. Esta sección es el documento original y está en inglés. # Obsidian Flavored Markdown Use this as a compact fallback for Obsidian-specific syntax. Prefer a separately installed `kepano/obsidian-skills` `obsidian-markdown` skill when available, then current [Obsidian Help](https://help.obsidian.md/), for detailed or version-sensitive questions. Resolve the installed product root from this skill's own location, not from the vault or current working directory: ```bash PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py" test -f "$CORE" ``` Answer syntax questions read-only. If the user requests a vault edit, draft the complete note, read [operation-transactions.md](../wiki/references/operation-transactions.md), and build one `claude-obsidian.transaction.v1` bundle with `operation_type: markdown` and only `wiki/` targets. Inspect it, then set `APPROVAL_SHA256` to the returned `approval_sha256` after review and apply it through the same vault-bound plan. A canonical page create or removal includes an active index or MOC update in that bundle; update the overview only when its stable high-level synthesis changed: ```bash python3 "$CORE" transaction inspect "$BUNDLE" --vault "$VAULT" python3 "$CORE" transaction apply "$BUNDLE" --vault "$VAULT" \ --approved-plan-sha256 "$APPROVAL_SHA256" ``` Never write a note directly. ## Properties Use flat YAML properties and `YYYY-MM-DD` dates. Quote wikilinks inside YAML. ```yaml --- type: concept title: "Contextual Retrieval" created: 2026-07-11 updated: 2026-07-11 status: developing tags: - retrieval - ai/knowledge aliases: - Context-aware retrieval related: - "[[Retrieval]]" sources: - "[[Anthropic Contextual Retrieval]]" --- ``` Do not nest objects in generated wiki properties. Use block lists rather than inline YAML arrays. Quote numeric-only tag values, for example `- "2026"`, so YAML parsers preserve them as tags instead of numbers. Keep unknown existing properties unless the requested edit changes them. ## Wikilinks and embeds ```markdown [[Note Name]] [[Note Name|Display text]] [[Note Name#Heading]] [[Note Name#^block-id]] [[Folder/Note Name]] This paragraph is addressable. ^evidence-block ![[Note Name#Summary]] ![[diagram.png|480]] ![[paper.pdf#page=3]] ``` Match the target filename exactly. Use a vault-relative folder path when a basename is ambiguous. Use standard Markdown links for external URLs; use wikilinks for this vault's notes. ## Callouts ```markdown > [!note] > Supporting context. > [!warning] Review required > This claim has contradictory evidence. > [!question]- Open question > What evidence would resolve this? ``` `-` starts collapsed and `+` starts expanded. Common built-in types include `note`, `abstract`, `info`, `todo`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, and `quote`. Preserve custom vault callout types rather than rewriting them. ## Other Obsidian syntax ````markdown #inline-tag #nested/tag ==Highlighted text== Visible text %%hidden comment%% Inline math: $E = mc^2$ $$ \int_0^1 x^2\,dx = \frac{1}{3} $$ ```mermaid flowchart LR Source --> Claim ``` ```` Standard CommonMark/GFM headings, lists, tasks, tables, code fences, and footnotes remain valid. Avoid HTML when native Markdown is sufficient. ## Validate a drafted note - Parse the YAML boundary and keep property types consistent. - Verify every internal target, heading, and block reference that can be checked locally; never fabricate a target to make a link look complete. - Keep evidence wording distinct from inference and preserve source locators. - Ensure code fences and callout quoting are balanced. - Run deterministic wiki lint after a requested mutation and report remaining findings without silently repairing them. For source-cited pages, also follow [provenance.md](../wiki/references/provenance.md). Report the transaction operation ID and exact changed paths after an applied edit. ## Dónde encaja - Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales. - Creador: [AgriciDaniel](https://skillsagentes.com/creators/agricidaniel.md) — 46 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Wiki](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki.md): Inicializa, adopta y enruta el trabajo hacia un vault de Obsidian separado a través del core portátil `claude-obsidian`. Para configurar el vault o elegir el sub-skill correcto. - [Defuddle](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/defuddle.md): Planifica y, con consentimiento explícito de red, usa un limpiador externo Defuddle opcional para extraer páginas HTTPS tipo artículo como Markdown. - [Obsidian Bases](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-bases.md): Explica, redacta y valida archivos Obsidian Bases `.base` con filtros, fórmulas, propiedades, resúmenes y vistas de tabla, tarjetas o lista. - [Save](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/save.md): Guarda una respuesta, decisión, insight o resumen de sesión seleccionado por el usuario en un vault de Obsidian como una única transacción revisada, no cuando aporta un archivo o URL. - [Canvas](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/canvas.md): Crea, inspecciona y actualiza tableros Obsidian JSON Canvas con nodos de texto, archivo, enlace, grupo y arista. Para estado del canvas, mapas visuales, zonas y diseños espaciales. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)