El muestrario

§1.1Marcas inline

El análisis del énfasis es amigable con el CJK: la negrita cierra incluso pegada a puntuación china — **报文。**同时 se renderiza como 报文。同时, y no como asteriscos literales. La cursiva, el tachado y el código inline funcionan como siempre; con el interruptor gemoji, un atajo como :sparkles: se renderiza como ✨. Los caracteres dentro del código inline no participan en ningún análisis, así que las comillas invertidas son la manera segura de mostrar sintaxis: **, $…$ y > [!note] aparecen tal cual. Para mostrar un asterisco en la prosa, escápalo — *así* se queda plano.

§1.2Wikilinks

Con el interruptor wikilinks encendido, los enlaces [[de doble corchete]] se resuelven contra la colección de notas como una wiki espera: por id (design-tokens — desde una página del espejo español, el enlace prefiere el espejo del mismo idioma y solo cae en el original inglés si la nota no existe aquí), por alias (boundaries llega a la nota cuyo id es three-way-split) y con rótulo (la guía de primeros pasos). Un destino que no resuelve a nada se renderiza como enlace muerto marcado en lugar de tumbar el build — y la CLI check-wikilinks del motor lo reporta en CI, que es donde la podredumbre de enlaces pertenece.

§1.3Tablas: scroll cuando son anchas, tarjetas cuando el hueco es estrecho

Una tabla de seis columnas o más debería refluir a una tarjeta por fila en un contenedor estrecho, en lugar de estrujar cada celda a dos caracteres. Esta tabla de siete columnas es a la vez la chuleta de variantes de callout y una prueba en vivo de ese reflujo (encoge la ventana al ancho de un teléfono):

Los títulos por defecto están en inglés; un sitio cambia el juego entero con la opción calloutLabels de siteMarkdown, p. ej. calloutLabels: { tip: 'Intuición · Intuition' }. Un título escrito en la sintaxis de cita (> [!tip] Mi título) siempre gana.

§2.1Callouts: tres escrituras

Primero, la sintaxis de cita de Obsidian/GitHub (disponible con callouts: true; funciona también en archivos de Markdown plano):

El marcador de plegado de Obsidian se respeta — > [!note]- se renderiza plegado, > [!note]+ abierto:

Segundo, el componente del paquete en MDX (astro-inkstone/components/Callout.astro, importado por ruta). Sin title muestra el rótulo por defecto de la variante, el mismo que usa la sintaxis de cita:

Tercero, HTML crudo, las seis variantes de una pasada (en correspondencia una a una con las reglas .callout de base.css):

§2.2Matemáticas

Las fórmulas inline se asientan en el texto: la profundidad óptica se lee $\tau = \int \kappa \rho \, \mathrm{d}s$. Las fórmulas en display toman la forma de tres líneas ($$ en líneas propias) — el guardián rechaza la forma de una sola línea, que se renderizaría en silencio como una fórmula inline pequeña:

El fondo de las fórmulas es a propósito un papel distinto del cuerpo, y cambia con el tema. Y de paso: escapa los precios en dólares en la prosa — este café cuesta $3.

§3.1Marcos de código

Un bloque con title="…" recibe una barra de título con el nombre del archivo; el botón de copiar de la esquina es de todo el sitio. Las anotaciones de línea [!code ++] / [!code --] se renderizan como fondos de diff:

def build_pipeline(opts):
    plugins = [remark_math]  
    plugins = [remark_gemoji, remark_math]  
    return assemble(plugins, guard=opts.guard)

Un marco con la marca collapse empieza plegado y solo ocupa espacio al abrirse — ideal para archivos de configuración largos:

site:
  markdown:
    numbering: chapters
    math: true
    codeFrame: true
    mermaid: true
    callouts: true
    wikilinks: true
  styles:
    - astro-inkstone/styles/tokens.css
    - astro-inkstone/styles/base.css

El resaltado de doble tema viene de shiki, que emite ambos juegos de color a la vez; base.css elige uno por data-theme en un único lugar — sin tira y afloja de especificidad.

§3.2Diagramas mermaid

Un bloque ```mermaid deja solo un marcador de posición en tiempo de build; el renderizador se carga dinámicamente solo en las páginas que llevan un diagrama (las que no llevan ninguno no pagan nada) y vuelve a renderizar cuando el tema cambia:

flowchart LR
  A["astro-inkbrush<br/>motor: edición / dialecto / guardián"] --> C["tu sitio<br/>identidad / rutas / despliegue"]
  B["astro-inkstone<br/>papel: tokens / estilos / pipeline"] --> C
  A -. un dialecto compartido .-> B

§3.3Extras de GFM

Las listas de tareas y las notas al pie llegan con GFM:

• tokens importados
• base.css importado
• paleta de identidad sobrescrita

Una afirmación que merece fuente lleva su nota al pie.¹

§4.1Lo que el guardián rechaza en esta página

Que esta página compile es en sí la demostración de que todo lo anterior está bien formado. Estas escrituras harían fallar el build en el acto (prueba una y luego npm run build):

• un marcador de énfasis sin pareja posible, como un ** abierto al final de una línea;
• $$x$$ en una sola línea (usa la forma de tres líneas);
• títulos numerados a mano — escribir el título de esta sección como ## 9. Lo que el guardián… chocaría con la numeración de build y quedaría señalado;
• MDX evaluando las llaves de tu prosa: {0,1,2,3} se renderizaría como un simple 3, así que el guardián exige la forma escapada {0,1,2,3};
• una fórmula que KaTeX no puede renderizar (el guardián vuelve a renderizar cada fórmula en modo estricto en lugar de dejar que el texto rojo de error llegue a producción).