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:
Este es un bloque de información general con tono azul eléctrico. Ideal para contexto adicional o notas explicativas.
Puedes usar Markdown dentro de los callouts, como negritas, cursivas o código en línea.
Ten en cuenta que modificar ciertas variables de entorno puede alterar el comportamiento del runtime de Deno.
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:
Esta alerta fue escrita utilizando la sintaxis estándar > [!NOTE] de GitHub Flavored Markdown.
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]:
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:
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:
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
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`) #
Inicializa tu proyecto
Ejecuta deno run -A jsr:@zerho/core/init en cualquier repositorio para generar la estructura base.
Personaliza tu configuración
Ajusta colores, barra lateral automática (sidebar: "auto") y plugins en zerho.config.ts.
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:
Tablas de Comparación #
| Característica | VitePress Estándar | Zerho 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** |