# Formato Obsidian

> Referencia de sintaxis Obsidian Flavored Markdown. Consultar cuando se escriban notas que usen wikilinks, embeds, callouts, block IDs, math, footnotes u otra sintaxis especifica de Obsidian.

- Skill: `vasallo94/formato-obsidian` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vasallo94/formato-obsidian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vasallo94/formato-obsidian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Vasallo94 (https://skillmd.com/u/vasallo94)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vasallo94/formato-obsidian

---


# Formato Obsidian - Referencia de Sintaxis

Skill de referencia para escribir Obsidian Flavored Markdown correctamente. Cubre las extensiones de Obsidian sobre CommonMark y GFM. El Markdown estandar (cabeceras, negrita, cursiva, listas, citas, bloques de codigo, tablas) se asume como conocimiento previo.

> [!CAUTION]
> Antes de crear o editar notas, lee las [[.agents/REGLAS_GLOBALES|Reglas Globales]]. Esta skill complementa las reglas con la sintaxis exacta.

## Enlaces internos (Wikilinks)

```markdown
[[Nombre de Nota]]                     Enlace a nota
[[Nombre de Nota|Texto visible]]       Texto personalizado
[[Nombre de Nota#Cabecera]]            Enlace a cabecera
[[Nombre de Nota#^block-id]]           Enlace a bloque
[[#Cabecera en la misma nota]]         Enlace a cabecera local
```

Para definir un block ID, anadir `^block-id` al final de cualquier parrafo:

```markdown
Este parrafo puede ser enlazado directamente. ^mi-block-id
```

Para listas y citas, colocar el block ID en una linea separada despues del bloque:

```markdown
> Una cita

^id-cita
```

> [!TIP]
> Usar `[[wikilinks]]` para notas dentro del vault (Obsidian gestiona renombrados automaticamente). Usar `[texto](url)` solo para URLs externas.

## Embeds

Prefijar cualquier wikilink con `!` para incrustar su contenido:

```markdown
![[Nombre de Nota]]                    Incrustar nota completa
![[Nombre de Nota#Cabecera]]           Incrustar seccion
![[imagen.png]]                        Incrustar imagen
![[imagen.png|300]]                    Imagen con ancho
![[imagen.png|640x480]]               Imagen con ancho x alto
![[documento.pdf]]                     Incrustar PDF
![[documento.pdf#page=3]]              Pagina especifica del PDF
![[audio.mp3]]                         Incrustar audio
```

Imagenes externas:

```markdown
![Texto alternativo](https://ejemplo.com/imagen.png)
![Texto alternativo|300](https://ejemplo.com/imagen.png)
```

Incrustar resultados de busqueda:

````markdown
```query
tag:#proyecto status:completo
```
````

## Callouts

```markdown
> [!note]
> Callout basico.

> [!warning] Titulo personalizado
> Callout con titulo propio.

> [!faq]- Colapsado por defecto
> Contenido plegable (- colapsado, + expandido).
```

Callouts anidados:

```markdown
> [!question] Callout exterior
> > [!note] Callout interior
> > Contenido anidado
```

### Tipos de callout disponibles

| Tipo | Aliases | Uso |
|------|---------|-----|
| `note` | - | Informacion contextual |
| `abstract` | `summary`, `tldr` | Resumenes |
| `info` | - | Datos informativos |
| `todo` | - | Pendientes |
| `tip` | `hint`, `important` | Recomendaciones |
| `success` | `check`, `done` | Confirmaciones |
| `question` | `help`, `faq` | Preguntas frecuentes |
| `warning` | `caution`, `attention` | Advertencias y riesgos |
| `failure` | `fail`, `missing` | Fallos |
| `danger` | `error` | Peligros criticos |
| `bug` | - | Errores conocidos |
| `example` | - | Ejemplos |
| `quote` | `cite` | Citas |

> [!IMPORTANT]
> En nuestro vault usamos principalmente `note`, `tip`, `warning`, `important` y `caution` segun las Reglas Globales.

## Frontmatter (Properties)

```yaml
---
created: 2026-06-09
type: conocimiento
status: borrador
tags:
  - tema
aliases:
  - Nombre Alternativo
cssclasses:
  - clase-css
---
```

### Tipos de propiedades

| Tipo | Ejemplo |
|------|---------|
| Texto | `title: Mi Titulo` |
| Numero | `rating: 4.5` |
| Checkbox | `completed: true` |
| Fecha | `created: 2026-06-09` |
| Fecha y hora | `due: 2026-06-09T14:30:00` |
| Lista | `tags: [uno, dos]` o lista YAML |
| Enlaces | `related: "[[Otra Nota]]"` |

### Propiedades por defecto de Obsidian

- `tags` — etiquetas de la nota (buscables, visibles en el grafo)
- `aliases` — nombres alternativos (aparecen en sugerencias de enlace)
- `cssclasses` — clases CSS aplicadas a la nota

### Propiedades de nuestro vault

- `type` — tipo de nota (obligatorio, ver Reglas Globales)
- `status` — estado: `borrador`, `en_proceso`, `completo`, `archivo`
- `created` — fecha de creacion
- `updated` — fecha de ultima edicion (solo al editar)
- `source_url` — URL de origen (para recursos)
- `source_type` — tipo de fuente (para recursos)

## Tags

```markdown
#tag                    Tag inline
#nested/tag             Tag con jerarquia
#tag-con-guiones        Guiones permitidos
#tag_con_guion_bajo     Guiones bajos permitidos
```

Restricciones: pueden contener letras, numeros (no como primer caracter), guiones bajos, guiones y barras `/` (para anidamiento).

> [!WARNING]
> En nuestro vault las tags son solo para tematica. Estado y tipo van en frontmatter.

## Comentarios

```markdown
Texto visible %%pero esto esta oculto%% en vista de lectura.

%%
Este bloque completo esta oculto en vista de lectura.
%%
```

## Resaltado

```markdown
==Texto resaltado==
```

## Matematicas (LaTeX)

Inline:

```markdown
La formula $e^{i\pi} + 1 = 0$ es elegante.
```

Bloque:

```markdown
$$
\frac{a}{b} = c
$$
```

## Diagramas Mermaid

````markdown
```mermaid
graph TD
    A[Inicio] --> B{Decision}
    B -->|Si| C[Hacer esto]
    B -->|No| D[Hacer aquello]
```
````

Para enlazar nodos Mermaid a notas de Obsidian:

````markdown
```mermaid
graph TD
    A[Mi Nota]
    class A internal-link;
```
````

> [!WARNING]
> Recordar: evitar `()` dentro de nodos `[]`, usar etiquetas en flechas para detalles. Ver skill [[diagrama-arquitectura]] para convenciones avanzadas.

## Notas al pie

```markdown
Texto con una nota al pie[^1].

[^1]: Contenido de la nota al pie.

Nota al pie inline.^[Esto es inline.]
```

## Ejemplo completo

````markdown
---
created: 2026-06-09
type: conocimiento
status: borrador
tags:
  - arquitectura
---

# Patrones de Diseno en Python

Este documento recopila los patrones mas usados en [[Proyecto Alpha]].

> [!important] Contexto
> Estos patrones se aplican al ==backend== del proyecto.

## Singleton

El patron Singleton garantiza una unica instancia[^1].

```python
class Singleton:
    _instance = None

    @classmethod
    def get_instance(cls):
        if cls._instance is None:
            cls._instance = cls()
        return cls._instance
```

La complejidad es $O(1)$ para cada acceso. Ver [[Algoritmos#Complejidad]] para mas detalle.

![[diagrama-singleton.png|600]]

Revisado en [[Reunion 2026-06-09#Decisiones]].

[^1]: Gamma et al., Design Patterns, 1994.
````