Sobre Visor de Markdown
El visor de Markdown de Zyff abre un archivo .md — o cualquier cosa que pegues — y lo muestra como lo haría GitHub: encabezados, tablas, listas de tareas, notas al pie, código con resaltado de sintaxis y HTML incrustado, con un índice construido a partir de los propios encabezados del documento. El dibujado ocurre en los servidores de Zyff y no en el cliente, lo que en esta herramienta es tanto una decisión de seguridad como de arquitectura. El Markdown deja pasar HTML puro a propósito, así que un documento venido de un repositorio, de un cliente o de un desconocido es marcado no fiable por definición; todas las etiquetas de la salida de aquí, o vienen del propio renderizador, o han sobrevivido a una lista de permitidos del servidor que elimina scripts, manejadores de eventos, iframes y estilos en línea. Tu archivo se procesa en memoria y nunca se guarda. No hay registro, ni marca de agua, ni límite de cuántos documentos abres.
Cómo abrir y ver un archivo Markdown
Abre o pega el documento
Haz clic en Abrir archivo y elige un .md, .markdown o .txt, arrastra uno a cualquiera de los dos paneles, o cambia a la pestaña de Markdown y pega. Un archivo se sube y se descodifica en el servidor, así que un archivo que no sea UTF-8 te lo dice en vez de dibujarse como signos de interrogación.
Léelo en Vista previa, o edítalo en Dividido
Vista previa muestra el documento dibujado por su cuenta. Dividido pone la fuente al lado y lo vuelve a dibujar mientras escribes, que es lo que quieres cuando estás arreglando una tabla que no se ve. Markdown muestra solo la fuente.
Comprueba la variante si algo se ve raro
Abre las opciones y confirma que el Markdown con sabor de GitHub está activado: las tablas, las listas de tareas, el tachado y las notas al pie son extensiones de GFM y no forman parte del Markdown básico, y un renderizador que no las tenga muestra tu tabla como barras verticales literales.
Muévete con el índice
Cualquier documento con más de un encabezado recibe un índice construido con esos encabezados, cada uno enlazando con su propia ancla. Las anclas siguen el formato de identificador de GitHub, así que un índice ya escrito en tu README funciona aquí también.
Exporta lo que necesites
Copia el HTML dibujado, descarga un archivo .html independiente que se abre en cualquier sitio con sus estilos ya dentro, vuelve a guardar el Markdown, o usa Imprimir para producir un PDF. Al imprimir se imprime el documento, no la página que lo rodea.
Qué hace Visor de Markdown
Markdown con sabor de GitHub, notas al pie incluidas
Tablas con alineación de columnas, listas de tareas, tachado, autoenlace de URL sueltas, notas al pie y los avisos [!NOTE] y [!WARNING] de GitHub. Estas son las extensiones de las que depende un README de verdad, y las que un renderizador estricto de CommonMark no te va a mostrar.
El HTML incrustado se dibuja, no se elimina, a través de una lista de permitidos
Las insignias, los bloques <details>, <img align="right"> y <picture> se dibujan como en GitHub. Los scripts, los manejadores de eventos, los iframes, los formularios, los estilos en línea y los atributos desconocidos se eliminan en el servidor, contenga lo que contenga el documento.
Resaltado de sintaxis para los lenguajes que de verdad pegas
JavaScript, TypeScript, Python, Go, Rust, Java, C y C++, C#, PHP, Ruby, SQL, JSON, YAML, TOML, HTML, CSS, shell, Dockerfile, GraphQL, diffs unificados y el propio Markdown, resueltos a partir de la cadena informativa del bloque y sus alias habituales.
Un índice con anclas compatibles con GitHub
Se construye con los mismos encabezados que emitió el renderizador, así que una entrada nunca puede apuntar a un ancla que no está en la página. Los encabezados repetidos reciben el sufijo -1, -2 que usa GitHub, que es lo que hace que un índice escrito a mano siga funcionando.
El front matter se reconoce, no se imprime
Un bloque YAML o TOML al principio del archivo se saca aparte y se muestra como campos en vez de dibujarse como un --- suelto y una tanda de líneas de clave: valor, que es como se ve una página de Hugo o Jekyll en un visor que no lo conoce.
Estadísticas del documento del mismo análisis
Palabras, tiempo de lectura, encabezados, enlaces, imágenes, bloques de código, tablas y tareas hechas, todo contado durante el dibujado. Los bloques de código y el front matter quedan fuera del recuento de palabras, así que el tiempo de lectura describe lo que de verdad leerías.
Modo CommonMark, para averiguar el porqué
Desactiva el Markdown con sabor de GitHub y el documento se dibuja con CommonMark estricto. Es la forma más rápida de ver si la tabla que no aparece en npm es una tabla de GFM en un renderizador que no las admite.
At a glance
| Archivos aceptados | .md, .markdown, .mdown, .mkd, .mkdn, .mdx y .txt, de hasta 2 MB |
|---|---|
| Límite del documento | 500.000 caracteres o 60.000 líneas, comprobados en el servidor |
| Variantes | Markdown con sabor de GitHub (por defecto) o CommonMark estricto |
| HTML incrustado | Dibujado a través de una lista de permitidos del servidor, o mostrado como texto literal |
| Lenguajes resaltados | Resueltos a partir de la cadena informativa del bloque de código y sus alias habituales |
| Límite del resaltado | Los bloques de más de 40.000 caracteres se dibujan en monoespaciado simple |
| Índice | Hasta 500 encabezados, con identificadores de ancla compatibles con GitHub |
| Velocidad de lectura | 225 palabras por minuto por defecto; también están disponibles 180 y 300 |
| Exportaciones | Copiar HTML, .html independiente, el .md original, e imprimir a PDF |
| Almacenamiento | Ninguno — el documento se mantiene en memoria solo durante la petición |
Frequently asked questions
¿Cómo abro un archivo .md?
Ábrelo en cualquier visor de Markdown, incluido este: haz clic en Abrir archivo, o arrastra el .md a la página. Un archivo .md es texto plano, así que un editor de texto también lo abrirá, pero verás la sintaxis en vez del formato. No hay que instalar nada, y el archivo nunca se guarda.
¿Por qué no se dibuja mi tabla de Markdown?
Casi siempre porque el renderizador no admite Markdown con sabor de GitHub, o porque la fila delimitadora falta o está mal escrita. Las tablas son una extensión de GFM y no forman parte del Markdown básico, así que npm, algunos generadores de documentación y los renderizadores estrictos de CommonMark muestran las barras verticales como texto literal. La fila de guiones bajo la cabecera es lo que convierte una tabla en una tabla: sin ella, las barras son solo barras.
¿Por qué han desaparecido mis saltos de línea?
Porque en el Markdown estándar un único salto de línea dentro de un párrafo es un espacio, no un salto. Terminar la línea con dos espacios, o con una barra invertida, fuerza uno; o activa aquí "Los saltos de línea se convierten en <br>", que es como se comportan los cuadros de comentarios y las aplicaciones de chat. Esta es la sorpresa más habitual para quien escribió su primer Markdown en un gestor de incidencias.
¿Este visor ejecuta el HTML que hay dentro de mi Markdown?
Lo dibuja, a través de una lista de permitidos, y nada de lo que contiene puede ejecutarse. Los scripts, los manejadores de eventos, los iframes, los objetos, los formularios, los estilos en línea y los atributos desconocidos se eliminan en el servidor antes de que el HTML llegue siquiera a tu navegador, y los enlaces a URL javascript: o data: se descartan. También puedes desactivar por completo el dibujado de HTML, lo que muestra el marcado como texto literal.
¿Mi archivo se sube a algún sitio?
Se envía a los servidores de Zyff para dibujarlo y nunca se escribe en disco, ni se registra, ni se guarda en caché. El documento existe en memoria durante una petición. Dibujarlo en el servidor es lo que hace que una única lista de permitidos auditada sea responsable de la seguridad del resultado, en vez de una copia de esa lógica en cada paquete del navegador.
¿Puedo convertir Markdown a HTML con esto?
Sí. Copiar HTML te da el fragmento dibujado, y Descargar HTML te da un archivo independiente y completo con sus estilos ya dentro, así que se abre bien en un equipo que no ha oído hablar de Zyff en su vida. Los dos salen del mismo dibujado que estás viendo.
¿Admite diagramas de Mermaid o fórmulas de LaTeX?
No. Un bloque ```mermaid o ```math se dibuja como un bloque de código resaltado que muestra su fuente, que es lo que es. Los dos necesitan un motor de dibujado en el cliente, y esta herramienta a propósito no ejecuta ninguno: toda la base de su seguridad es que el navegador recibe HTML terminado y saneado y no ejecuta nada.
¿Puede abrir un archivo .mdx?
Sí, y el Markdown que hay dentro se dibuja con normalidad, pero sus componentes JSX se muestran como texto en vez de ejecutarse: el visor lo indica con una nota cuando ve una instrucción import. Ejecutar componentes salidos del archivo de otra persona no es algo que deba hacer un visor.
¿Por qué mis enlaces a encabezados funcionan en GitHub y no en otros sitios?
Porque los identificadores de ancla no están estandarizados, así que dos renderizadores pueden generar identificadores distintos para el mismo encabezado. Este visor usa el algoritmo de GitHub — minúsculas, puntuación eliminada, espacios a guiones, con un sufijo -1 o -2 en las repeticiones — así que un índice escrito para GitHub sigue funcionando aquí.
¿Hay algún límite de tamaño de archivo?
2 MB para un archivo subido, y 500.000 caracteres o 60.000 líneas para el propio documento. Eso es un documento único muy grande: la especificación de CommonMark en Markdown no llega a los 300.000 caracteres. Más allá, ve una sección cada vez.