Descargar el paquete de prueba en GitHub
Selecciona Code → Download ZIP para mantener juntos el documento y los archivos de imagen. El repositorio también te permite revisar el código fuente y los cambios antes de descargarlo.
El paquete tiene una licencia abierta CC BY 4.0. Puedes reutilizar o adaptar el material de prueba citando la fuente. Esto no convierte la app Markdific en código abierto.
Respuesta rápida: descarga el ZIP, abre el mismo archivo
.mden cada herramienta, anota qué se renderiza correctamente y luego guarda y exporta una copia de trabajo. Registra por separado los resultados de renderizado, de ida y vuelta en Markdown y de los formatos exportados.
Qué cubre la prueba
El documento de la versión 1.0 tiene 30 secciones numeradas. Cada sección indica si prueba CommonMark, GitHub Flavored Markdown (GFM), una extensión común, sintaxis específica de una aplicación, el comportamiento del HTML o un ciclo de ida y vuelta.
| Área | Ejemplos | Qué comprobar |
|---|---|---|
| CommonMark | Encabezados, enlaces, listas, citas, código, saltos de línea | Análisis y estructura del documento |
| GFM | Tablas, listas de tareas, tachado, enlaces automáticos | Compatibilidad con la sintaxis extendida |
| Imágenes | PNG, JPEG, WebP, nombres de archivo con espacios, imágenes remotas | Carga y conservación de rutas |
| Contenido técnico | Fórmulas LaTeX y siete tipos de diagramas Mermaid | Vista previa, código fuente como alternativa, exportación |
| Sintaxis específica de apps | Wikilinks, incrustaciones, callouts y etiquetas de Obsidian | Portabilidad y recuperabilidad |
| Ida y vuelta | Abrir, editar, guardar y exportar | Reescrituras del código fuente y contenido perdido |
Las fórmulas, Mermaid y la sintaxis de Obsidian no forman parte del núcleo de CommonMark. Una herramienta puede renderizar CommonMark con precisión sin admitirlos. El paquete es un documento práctico de comparación, no un conjunto formal de pruebas de conformidad con el estándar.
Cómo hacer una comparación justa
- Descarga el ZIP del repositorio. Extráelo sin separar el documento
.mddeassets/. - Conserva una copia de referencia sin tocar. Anota la versión de la aplicación, el sistema operativo, el modo del renderizador y la fecha de la prueba.
- Abre una copia de trabajo en la primera herramienta. Revisa el resultado renderizado y el código fuente, si está disponible.
- Haz una pequeña edición, guarda como Markdown y compara el archivo guardado con la copia de referencia.
- Exporta a cada formato que ofrezca la herramienta, como HTML, PDF o DOCX. Abre cada exportación y revísala por separado.
- Repite el proceso con la misma copia de referencia en las demás herramientas. Completa la tabla de resultados dentro del documento.
No reduzcas todas las observaciones a una sola puntuación de «admite Markdown». Un visor puede renderizar un diagrama pero no permitir editarlo. Un convertidor puede conservar su aspecto en PDF pero perder el código Mermaid. Son resultados distintos.
Etiquetas de resultado
- Correcto: la estructura y el significado se mantienen tras la operación probada.
- Parcial: el contenido sigue siendo utilizable, pero cambian el formato, el código fuente, los metadatos o la posibilidad de editarlo.
- No compatible: una extensión de sintaxis opcional no está implementada, pero el código fuente sigue siendo recuperable.
- Fallo: el contenido desaparece, se vuelve engañoso, ejecuta contenido inseguro o no se puede recuperar.
- No probado: la operación no se pudo completar o no corresponde.
Anota la evidencia que respalda cada etiqueta. Por ejemplo, «Mermaid mostrado como bloque de código legible» suele ser No compatible, no Fallo, salvo que la herramienta afirme renderizar Mermaid.
Pruebas de imágenes: qué debe cargarse y qué no
El ZIP contiene seis imágenes locales de prueba que funcionan: PNG, JPEG, WebP, un nombre de archivo con espacios, una imagen referenciada desde HTML y una imagen pegada al estilo de Obsidian. Mantén assets/ junto al documento. Los seis archivos usan a propósito el mismo dibujo sencillo, para que la comparación aísle el formato de archivo y el manejo de rutas de otras diferencias visuales que no vienen al caso.
Otras dos rutas quedan sin resolver a propósito en el paquete independiente. Una ruta relativa a la carpeta superior depende de una estructura de carpetas más amplia, y una ruta relativa a la raíz del sitio depende de un sitio web. La imagen remota depende del acceso a la red. Estos casos prueban cómo explica una herramienta los recursos ausentes o externos; no son archivos que falten en el ZIP.
Si fallan todas las imágenes locales incluidas, revisa la extracción, la ubicación de las carpetas y los permisos de los archivos locales antes de calificar el renderizador.
Qué revisar después de guardar y exportar
Las vistas previas pueden ocultar cambios en el código fuente. Revisa el Markdown guardado en busca de destinos de enlaces perdidos, rutas de imagen reescritas, tablas rotas, delimitadores de código alterados, caracteres escapados o metadatos eliminados. Una normalización inofensiva del formato no es lo mismo que una pérdida de significado.
En PDF, revisa los saltos de página, el ajuste del código, las fórmulas, la resolución de los diagramas y los enlaces. En DOCX, comprueba si los encabezados, las tablas, las listas y las imágenes siguen siendo editables. En HTML, revisa la estructura, los recursos locales y el tratamiento seguro del HTML sin procesar.
El documento incluye una prueba de script inofensiva. Una vista previa segura puede escaparlo, eliminarlo o mostrar el código sin ejecutarlo. No consideres un fallo que se bloquee la ejecución del script.
Comparte resultados reproducibles
Al publicar una comparación, incluye la versión del paquete (1.0), la herramienta y su versión, el sistema operativo, la configuración, el método de importación, los ajustes de exportación, la tabla de resultados completa y capturas de pantalla de las diferencias relevantes. Indica cualquier modificación del archivo de prueba.
Markdific creó el paquete y puede ser una de las aplicaciones probadas. Aplica el mismo archivo y las mismas definiciones de puntuación a todas las aplicaciones. No cuentes una función opcional como defecto solo porque un producto la implementa.
Descarga y reutilización
Abrir el paquete de prueba de compatibilidad de Markdown en GitHub
Usa Code → Download ZIP para obtener juntos el documento .md, assets/, el README y la licencia.
El documento y las imágenes de prueba incluidas tienen licencia CC BY 4.0. Cita «Markdific Markdown Compatibility Test Pack v1.0», enlaza al repositorio y a la licencia, e indica los cambios si adaptas el material.
Preguntas frecuentes
¿Es un conjunto de pruebas oficial de CommonMark?
No. CommonMark tiene su propia especificación y sus propios ejemplos de conformidad. Este paquete prueba documentos y flujos de trabajo prácticos, incluidas las extensiones y la exportación.
¿Puedo probar un generador de sitios estáticos?
Sí. Anota el motor, los plugins, la configuración, el tema, la versión de compilación y las reglas de rutas de los recursos. Compara el HTML y los archivos generados, no solo la vista previa de desarrollo.
¿Puedo publicar o modificar el paquete de prueba?
Sí, con la licencia CC BY 4.0. Cita la fuente, enlaza a la licencia e indica los cambios. Conserva el identificador de versión original en los resultados de la comparación para que los lectores sepan qué se probó.