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)

[[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:

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

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

> 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:

![[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:

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

Incrustar resultados de busqueda:

tag:#proyecto status:completo

Callouts

> [!note]
> Callout basico.

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

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

Callouts anidados:

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

Tipos de callout disponibles

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

Frontmatter (Properties)

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

Tipos de propiedades

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

#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

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

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

Resaltado

==Texto resaltado==

Matematicas (LaTeX)

Inline:

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

Bloque:

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

Diagramas 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:

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

Texto con una nota al pie[^1].

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

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

Ejemplo completo

---
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].

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.