Embeds de Obsidian: vídeo, audio, PDF y notas incrustadas con ejemplos

Video de gotas para los ojos

Los archivos de video se incrustan como reproductores de video HTML5 con controles y diseño responsivo.

sound.wav

Los archivos de audio se incrustan como reproductores de audio HTML5 con controles y visualización del nombre de archivo.

document.pdf

En Obsidian los PDFs se abren como visores en línea con enlaces de descarga. En MarkeUP el build no incrusta PDFs —solo audio, vídeo y las fichas de libro y película—, así que este wikilink se queda como concepto pendiente (el enlace en gris de arriba): para un documento, un enlace normal al archivo.

Usa ![[attachments/document.pdf#page=3]] para seleccionar una página específica del PDF para mostrar. Recuerda que los embeds de notas (![[slug]]) se hidratan desde /api/posts.json, como se explica en la guía de operación y en la guía de Vault CMS.

Los videos de YouTube se incrustan automáticamente con diseño responsivo y configuración optimizada. La fachada muestra la miniatura como póster y no carga nada del proveedor hasta el clic: npm run media:fetch descarga esa miniatura a public/img/media/ para que ni siquiera se pida a un tercero.

La sintaxis canónica es un bloque cercado con un lenguaje reservado (embed, audio, video, book, film): además del nombre accesible admite pie de figura y minuto de arranque. Las cinco formas, con sus opciones y sus límites, están en la guía de medios embebidos.

El mismo vídeo, con pie de figura y arranque en el segundo 30.

Las fichas también viven dentro del texto: un book sale de su ISBN y usa la misma caché que la tarjeta del principio del artículo.

X (Twitter) no es uno de los proveedores que MarkeUP incrusta: los admitidos son YouTube, Vimeo, Spotify, SoundCloud e iVoox. Un ![alt](url) de X no se traduce a nada y se publica como una imagen rota (lo avisa validate:media), así que esas notas se enlazan con un wikilink normal o se quedan sin incrustar.

Puedes incrustar bases con la sintaxis de directiva base:

filters:
  and:
    - file.ext == "md"
formulas:
  Slug: |-
    if(file.folder == "posts", "/posts/" + file.name.replace(".md", ""), 
      if(file.folder == "pages", "/" + file.name.replace(".md", ""), 
        if(file.folder == "special", if(file.name.replace(".md", "") == "home", "/", "/" + file.name.replace(".md", "")), 
          if(file.folder == "projects", "/projects/" + file.name.replace(".md", ""), 
            if(file.folder == "docs", "/docs/" + file.name.replace(".md", ""), 
              "/" + file.folder)))))
  Content Folder: |-
    if(file.name == "index",
      if(file.folder != "",
        if(file.folder.replace("/" + file.folder.replace(/.*\//, ""), "") != "",
          file.folder.replace("/" + file.folder.replace(/.*\//, ""), ""),
          file.folder
        ),
        "root"
      ),
      if(file.folder != "",
        file.folder,
        "root"
      )
    )
properties:
  note.title:
    displayName: Título
  note.date:
    displayName: Fecha
  note.pubDate:
    displayName: Fecha
  formula.Slug:
    displayName: Ruta
views:
  - type: table
    name: Posts
    filters:
      and:
        - file.folder.startsWith("posts")
    order:
      - title
      - formula.Slug
      - date
    sort:
      - property: date
        direction: DESC
    cardSize: 230
    image: note.image
    imageAspectRatio: 0.55
    columnSize:
      note.title: 235
  - type: cards
    name: Páginas Estándar
    filters:
      and:
        - file.folder.startsWith("pages")
    order:
      - title
      - formula.Slug
    sort:
      - property: title
        direction: ASC
  - type: cards
    name: Páginas Especiales
    filters:
      and:
        - file.folder.startsWith("special")
    order:
      - title
      - formula.Slug
    sort:
      - property: title
        direction: ASC
  - type: cards
    name: Proyectos
    filters:
      and:
        - file.folder.startsWith("projects")
    order:
      - title
      - formula.Slug
    sort:
      - property: date
        direction: DESC
    image: note.image
    cardSize: 200
    imageAspectRatio: 0.6
  - type: cards
    name: Documentación
    filters:
      and:
        - file.folder.startsWith("docs")
    order:
      - title
      - formula.Slug
    sort:
      - property: lastModified
        direction: DESC
    image: note.image
    imageAspectRatio: 0.8
  - type: cards
    name: Todo el Contenido
    order:
      - title
      - formula.Slug
    sort:
      - property: file.folder
        direction: ASC
    cardSize: 230
    image: note.image
    imageAspectRatio: 0.55

Al agregar un limit bajo views puedes limitar el número de elementos que aparecen.

views:
  - type: table
    name: Posts
    limit: 2

Esta es la sintaxis:

```yaml
views:
  - type: table
    name: Posts
    limit: 2
```

También puedes incrustar un .base como un embed de markdown:

![](bases/Home.base)

O como un embed de wikilink:

![[Home.base]]

Además de ficheros, en MarkeUP el embebido con un slug publicado muestra una tarjeta rica (preview con imagen, título, descripción, etiquetas y enlace):

Leer «silva-mind-control» →

[!info] Sintaxis: ![[silva-mind-control]]. En el navegador se hidrata automáticamente desde /api/posts.json y el resultado funciona como un bloque enlazable a ese artículo.

Este tema incluye soporte completo de matemáticas LaTeX usando KaTeX para renderizado rápido del lado del cliente. Todas las matemáticas funcionan perfectamente tanto en temas claros como oscuros.

Usa signos de dólar simples para matemáticas en línea: $E = mc^2$ o $\int_0^{2\pi} d\theta x+e^{-i\theta}$.

Usa signos de dólar dobles para matemáticas centradas de visualización:

$$ \begin{vmatrix}a & b\ c & d \end{vmatrix}=ad-bc $$

$$ f(x) = x^2 + 3x + 2 $$

Fracciones: $\frac{a}{b}$, $\frac{x^2 + 1}{x - 1}$
Superíndices: $x^2$, $e^{i\pi} + 1 = 0$
Subíndices: $x_1$, $H_2O$

$\alpha, \beta, \gamma, \delta, \epsilon, \theta, \lambda, \mu, \pi, \sigma, \phi, \omega$
$\Gamma, \Delta, \Theta, \Lambda, \Pi, \Sigma, \Phi, \Omega$

Sumatoria: $\sum_{i=1}^{n} x_i$
Producto: $\prod_{i=1}^{n} x_i$
Integral: $\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$
Límite: $\lim_{x \to 0} \frac{\sin x}{x} = 1$

$$ \begin{pmatrix} a & b \ c & d \end{pmatrix} \begin{pmatrix} x \ y \end{pmatrix} = \begin{pmatrix} ax + by \ cx + dy \end{pmatrix} $$

$$ \nabla \times \vec{E} = -\frac{\partial \vec{B}}{\partial t} $$

$$ i\hbar\frac{\partial}{\partial t}\Psi(\vec{r},t) = \hat{H}\Psi(\vec{r},t) $$

Las matemáticas funcionan perfectamente dentro de los callouts:

[!note] Demostración Matemática El teorema de Pitágoras establece que para un triángulo rectángulo: $$a^2 + b^2 = c^2$$

Donde $c$ es la hipotenusa y $a$ y $b$ son los otros dos lados.

[!tip] Integración por Partes La fórmula para integración por partes es: $$\int u , dv = uv - \int v , du$$

Esto es particularmente útil para integrales que involucran productos de funciones.

$$ \begin{aligned} f(x) &= ax^2 + bx + c \ f’(x) &= 2ax + b \ f”(x) &= 2a \end{aligned} $$

$$ f(x) = \begin{cases} x^2 & \text{si } x \geq 0 \ -x^2 & \text{si } x < 0 \end{cases} $$

Números naturales: $\mathbb{N} = {1, 2, 3, \ldots}$
Números reales: $\mathbb{R}$
Números complejos: $\mathbb{C}$
Unión de conjuntos: $A \cup B$
Intersección de conjuntos: $A \cap B$
Subconjunto: $A \subseteq B$

Puedes mezclar matemáticas con texto regular de forma fluida. Por ejemplo, la fórmula cuadrática es $x = \frac{1}{2}$, que nos da las raíces de cualquier ecuación cuadrática $ax^2 + bx + c = 0$.

Toda la notación matemática funciona idénticamente en Obsidian y en tu blog publicado:

Matemáticas en línea: sintaxis $...$
Matemáticas de visualización: sintaxis $$...$$
Comandos LaTeX: Soporte completo para comandos matemáticos LaTeX estándar
Letras griegas: Usa \alpha, \beta, etc.
Símbolos: Usa \sum, \int, \infty, etc.

En conjunto, este mantenimiento se apoya en la guía de Vault CMS y en la arquitectura del proyecto.

Demo de Embeds de Obsidian

Embeds de Obsidian: vídeo, audio, PDF y notas incrustadas con ejemplos

Demo de Embeds de Obsidian

Posts que enlazan a este artículo