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)

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

```query
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

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)

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

#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

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

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

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

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