# Obsidian Markdown

> Crea y edita Obsidian Flavored Markdown con wikilinks, embeds, callouts, propiedades y otra sintaxis propia de Obsidian.

Fuente: https://skillsagentes.com/skills/kepano/obsidian-skills/obsidian-markdown
Markdown: https://skillsagentes.com/skills/kepano/obsidian-skills/obsidian-markdown.md

Repositorio: https://github.com/kepano/obsidian-skills
Autor: kepano
Licencia: MIT
Actualizado: hace 6 meses
Coste de contexto: 66 tok instalada, 1.3k tok al activarse, 2.2k tok con todos los archivos del bundle
Bundle: 4 archivos, 8 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 kepano/obsidian-skills --skill obsidian-markdown --agent claude-code
# Cursor
npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent cursor
# Codex
npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent codex
# Gemini CLI
npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent gemini
# Windsurf
npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent windsurf
# Cline
npx -y skills add kepano/obsidian-skills --skill obsidian-markdown --agent cline
```

## Qué hace

- Crea y edita notas en Obsidian Flavored Markdown con wikilinks, embeds, callouts, propiedades, etiquetas y comentarios
- Añade frontmatter con propiedades como title, tags y aliases al inicio del archivo
- Enlaza notas internas con [[wikilinks]] y enlaces a encabezados o bloques específicos
- Incrusta contenido de otras notas, imágenes o PDFs con la sintaxis ![[embed]]
- Da formato a callouts, resaltados, LaTeX, diagramas Mermaid y notas al pie

## Cuándo usarla

- Se trabaja con archivos .md dentro de Obsidian
- El usuario menciona wikilinks, callouts, frontmatter, tags, embeds o notas de Obsidian

## Qué la activa

- "Crea una nota en Obsidian con frontmatter y tags"
- "Añade un callout de tipo warning a esta nota"
- "Cómo enlazo a un encabezado específico con wikilinks"
- "Incrusta esta imagen en la nota con ![[embed]]"

## Antes de instalar

- Asume conocimiento de Markdown estándar (encabezados, negritas, listas, citas, bloques de código).

## Archivos

- SKILL.md — 5 KB
- references/CALLOUTS.md — 1 KB
- references/EMBEDS.md — 861 B
- references/PROPERTIES.md — 1 KB

## SKILL.md

Reproducido tal cual desde kepano/obsidian-skills bajo MIT. Esta sección es el documento original y está en inglés.

# Obsidian Flavored Markdown Skill

Create and edit valid Obsidian Flavored Markdown. Obsidian extends CommonMark and GFM with wikilinks, embeds, callouts, properties, comments, and other syntax. This skill covers only Obsidian-specific extensions -- standard Markdown (headings, bold, italic, lists, quotes, code blocks, tables) is assumed knowledge.

## Workflow: Creating an Obsidian Note

1. **Add frontmatter** with properties (title, tags, aliases) at the top of the file. See [PROPERTIES.md](references/PROPERTIES.md) for all property types.
2. **Write content** using standard Markdown for structure, plus Obsidian-specific syntax below.
3. **Link related notes** using wikilinks (`[[Note]]`) for internal vault connections, or standard Markdown links for external URLs.
4. **Embed content** from other notes, images, or PDFs using the `![[embed]]` syntax. See [EMBEDS.md](references/EMBEDS.md) for all embed types.
5. **Add callouts** for highlighted information using `> [!type]` syntax. See [CALLOUTS.md](references/CALLOUTS.md) for all callout types.
6. **Verify** the note renders correctly in Obsidian's reading view.

> When choosing between wikilinks and Markdown links: use `[[wikilinks]]` for notes within the vault (Obsidian tracks renames automatically) and `[text](url)` for external URLs only.

## Internal Links (Wikilinks)

```markdown
[[Note Name]]                          Link to note
[[Note Name|Display Text]]             Custom display text
[[Note Name#Heading]]                  Link to heading
[[Note Name#^block-id]]                Link to block
[[#Heading in same note]]              Same-note heading link
```

Define a block ID by appending `^block-id` to any paragraph:

```markdown
This paragraph can be linked to. ^my-block-id
```

For lists and quotes, place the block ID on a separate line after the block:

```markdown
> A quote block

^quote-id
```

## Embeds

Prefix any wikilink with `!` to embed its content inline:

```markdown
![[Note Name]]                         Embed full note
![[Note Name#Heading]]                 Embed section
![[image.png]]                         Embed image
![[image.png|300]]                     Embed image with width
![[document.pdf#page=3]]               Embed PDF page
```

See [EMBEDS.md](references/EMBEDS.md) for audio, video, search embeds, and external images.

## Callouts

```markdown
> [!note]
> Basic callout.

> [!warning] Custom Title
> Callout with a custom title.

> [!faq]- Collapsed by default
> Foldable callout (- collapsed, + expanded).
```

Common types: `note`, `tip`, `warning`, `info`, `example`, `quote`, `bug`, `danger`, `success`, `failure`, `question`, `abstract`, `todo`.

See [CALLOUTS.md](references/CALLOUTS.md) for the full list with aliases, nesting, and custom CSS callouts.

## Properties (Frontmatter)

```yaml
---
title: My Note
date: 2024-01-15
tags:
  - project
  - active
aliases:
  - Alternative Name
cssclasses:
  - custom-class
---
```

Default properties: `tags` (searchable labels), `aliases` (alternative note names for link suggestions), `cssclasses` (CSS classes for styling).

See [PROPERTIES.md](references/PROPERTIES.md) for all property types, tag syntax rules, and advanced usage.

## Tags

```markdown
#tag                    Inline tag
#nested/tag             Nested tag with hierarchy
```

Tags can contain letters, numbers (not first character), underscores, hyphens, and forward slashes. Tags can also be defined in frontmatter under the `tags` property.

## Comments

```markdown
This is visible %%but this is hidden%% text.

%%
This entire block is hidden in reading view.
%%
```

## Obsidian-Specific Formatting

```markdown
==Highlighted text==                   Highlight syntax
```

## Math (LaTeX)

```markdown
Inline: $e^{i\pi} + 1 = 0$

Block:
$$
\frac{a}{b} = c
$$
```

## Diagrams (Mermaid)

````markdown
```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
```
````

To link Mermaid nodes to Obsidian notes, add `class NodeName internal-link;`.

## Footnotes

```markdown
Text with a footnote[^1].

[^1]: Footnote content.

Inline footnote.^[This is inline.]
```

## Complete Example

````markdown
---
title: Project Alpha
date: 2024-01-15
tags:
  - project
  - active
status: in-progress
---

# Project Alpha

This project aims to [[improve workflow]] using modern techniques.

> [!important] Key Deadline
> The first milestone is due on ==January 30th==.

## Tasks

- [x] Initial planning
- [ ] Development phase
  - [ ] Backend implementation
  - [ ] Frontend design

## Notes

The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.

![[Architecture Diagram.png|600]]

Reviewed in [[Meeting Notes 2024-01-10#Decisions]].
````

## References

- [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown)
- [Internal links](https://help.obsidian.md/links)
- [Embed files](https://help.obsidian.md/embeds)
- [Callouts](https://help.obsidian.md/callouts)
- [Properties](https://help.obsidian.md/properties)

## Dónde encaja

- Categoría: [Documentos](https://skillsagentes.com/categorias/documentos.md) — Lee, escribe y transforma archivos PDF, DOCX, XLSX y PPTX.
- Creador: [kepano](https://skillsagentes.com/creators/kepano.md) — 5 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

- [Obsidian Bases](https://skillsagentes.com/skills/kepano/obsidian-skills/obsidian-bases.md): Crea y edita Obsidian Bases (archivos .base) con views, filters, formulas y summaries; para archivos .base, vistas tipo base de datos, table views, card views, filters o formulas en Obsidian.
- [Defuddle](https://skillsagentes.com/skills/kepano/obsidian-skills/defuddle.md): Extrae markdown limpio de páginas web con Defuddle CLI, eliminando clutter y navegación para ahorrar tokens; úsalo en vez de WebFetch para URLs que no sean .md.
- [Obsidian Cli](https://skillsagentes.com/skills/kepano/obsidian-skills/obsidian-cli.md): Interactúa con vaults de Obsidian mediante la CLI de Obsidian para leer, crear, buscar y gestionar notas, tareas y propiedades, y para desarrollar y depurar plugins y temas.
- [Json Canvas](https://skillsagentes.com/skills/kepano/obsidian-skills/json-canvas.md): Crea y edita archivos JSON Canvas (.canvas) con nodos, bordes, grupos y conexiones, para usar con archivos Canvas de Obsidian, mapas mentales o diagramas de flujo.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)