Saltar al contenido principal
5 min de lectura
Editar en GitHub

Superpoderes Markdown

Descubre todas las capacidades enriquecidas de autoría en Zerho.

Callouts y Contenedores Personalizados #

Zerho soporta contenedores estilizados estilo VitePress para resaltar notas, sugerencias, precauciones y detalles desplegables:

INFORMACIÓN

Este es un bloque de información general con tono azul eléctrico. Ideal para contexto adicional o notas explicativas.

CONSEJO PRO

Puedes usar Markdown dentro de los callouts, como negritas, cursivas o código en línea.

ADVERTENCIA

Ten en cuenta que modificar ciertas variables de entorno puede alterar el comportamiento del runtime de Deno.

PELIGRO

No expongas credenciales privadas ni claves de API en el código estático del cliente.

Haz clic para ver detalles avanzados

Aquí puedes colocar contenido colapsable que no sobrecargue la lectura inicial del usuario, como registros de depuración o tablas extensas.


Compatibilidad con Alertas de GitHub #

Zerho también procesa automáticamente la sintaxis estándar de alertas de GitHub:

NOTE

Esta alerta fue escrita utilizando la sintaxis estándar > [!NOTE] de GitHub Flavored Markdown.

TIP

También puedes utilizar > [!TIP] y > [!IMPORTANT] de manera intercambiable.


Bloques de Código con Pestaña de Archivo #

Al documentar código de producción, puedes especificar el nombre del archivo entre corchetes [archivo.ext]:

TS [SERVER.TS]
import { serve } from "jsr:@std/http";

serve((req) => {
  return new Response("¡Hola desde Zerho en Deno 2!");
}, { port: 8000 });

Bloques Ejecutables Interactivos #

Si agregas la palabra clave run a un bloque de código (por ejemplo: ts run), Zerho lo transforma en un Sandbox Interactivo de Deno con botón de ejecución y consola en vivo:

Deno Sandbox
const datos = "Mensaje secreto para Deno";
console.log("Calculando resumen criptográfico...");

const encoder = new TextEncoder();
const digest = await crypto.subtle.digest("SHA-256", encoder.encode(datos));
const hash = Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join(
  "",
);

console.log("Texto original:", datos);
console.log("Hash SHA-256 :", hash);

Diagramas Mermaid Nativos #

Escribe diagramas en texto plano utilizando la sintaxis mermaid. Zerho los procesa e interactúa dinámicamente:

Diagrama Mermaid
sequenceDiagram
  autonumber
  actor Usuario as Desarrollador
  participant Browser as Navegador
  participant Sandbox as Web Worker Sandbox
  participant Deno as Deno Deploy Edge

  Usuario->>Browser: Escribe código en la doc
  Usuario->>Browser: Clic en "Ejecutar en Deno"
  Browser->>Sandbox: Envía código TypeScript
  Sandbox->>Sandbox: Elimina tipos & evalúa
  Sandbox-->>Browser: Retorna stdout, logs y ms
  Browser-->>Usuario: Muestra consola interactiva

Grupos de Código Polyglot Sincronizados (`::: code-group`) #

Cuando documentas bibliotecas o herramientas multiplataforma, puedes agrupar comandos o ejemplos en pestañas con sincronización global client-side:

deno add jsr:@zerho/zerho
SINCRONIZACIÓN AUTOMÁTICA

Si el usuario selecciona la pestaña pnpm o Deno, Zerho memoriza su preferencia en localStorage y actualiza automáticamente todos los grupos de código del sitio web para mostrar su gestor de paquetes favorito.


Componentes UI Declarativos #

Zerho incluye contenedores nativos de alto impacto visual sin requerir MDX ni React:

Pasos Numerados (`::: steps`) #

1

Inicializa tu proyecto

Ejecuta deno run -A jsr:@zerho/core/init en cualquier repositorio para generar la estructura base.

2

Personaliza tu configuración

Ajusta colores, barra lateral automática (sidebar: "auto") y plugins en zerho.config.ts.

3

Compila y despliega en el Edge

Ejecuta deno task build para generar el sitio estático, feeds RSS, tarjetas OpenGraph y contexto MCP.

Pestañas de Contenido General (`::: tabs`) #

Zerho se ejecuta directamente sobre Deno 2 sin node_modules, aprovechando deno doc y Deno.serve.

Cuadrícula de Tarjetas (`::: cards`) #

⚡ **Compilación Sub-100ms** | Motor SSG ultrarrápido optimizado para Deno 2 y Deno Deploy. |

🔌 **OpenAPI 3.1 Nativo** | Explorador interactivo con resolución de `$ref` y snippets en 5

🤖 **MCP Server & LLMs.txt** | Conecta Cursor, Claude Desktop y Windsurf directamente a tu

Árbol de Archivos (`::: file-tree`) #

📄 zerho.config.ts
📄 main.ts
📁 docs/
📄 index.md
📁 guide/
📄 getting-started.md
📄 markdown-features.md

Fórmulas Matemáticas (LaTeX / KaTeX) #

Zerho soporta notación matemática en línea como $E = mc^2$ y bloques de ecuaciones completas con carga bajo demanda de KaTeX:

$$\text{Latencia Edge} = \frac{1}{\sum_{i=1}^{N} \text{Regiones}_i} + \mathcal{O}(1)$$

Tablas de Comparación #

CaracterísticaVitePress EstándarZerho Pro
**Runtime Base**Node.js / npm**Deno 2 Nativo**
**Playground en Vivo**❌ Requiere plugins**✅ Nativo de Serie**
**Despliegue Edge**Configuración manual**✅ 1 Clic Deno Deploy**
**Búsqueda Instantánea**Algolia externo / local básico**✅ Minisearch Cmd+K integrado**
**Diagramas Mermaid**Requiere dependencias extra**✅ Incluido de serie**
**Code Groups Sincronizados**Requiere bundler Node**✅ Nativo con LocalStorage**
**Tiempos de Arranque**~2.5s**~180ms**