Cómo usarla
- Escribe Markdown en el editor o pulsa «Probar un ejemplo» para cargar un documento con tablas y una lista de tareas.
- Observa cómo se actualiza la vista previa mientras escribes. Cambia a «Código fuente HTML» para ver el marcado generado.
- Activa o desactiva GitHub Flavored Markdown o los saltos de línea simples según dónde vayas a publicar el texto.
- Copia el HTML en un CMS o correo electrónico, o descarga el resultado como archivo .html o .md.
Cómo funciona
Markdown se convierte con marked, un analizador de código abierto muy utilizado que sigue la especificación CommonMark y, si se activa la opción GFM, GitHub Flavored Markdown: tablas con barras verticales y alineación de columnas, listas de tareas, ~~tachado~~ y enlaces automáticos para URL sin formato. Las notas al pie, las fórmulas matemáticas y los diagramas Mermaid no forman parte de estas especificaciones y se muestran como texto sin formato.
Markdown puede incluir HTML sin procesar, que se conserva sin cambios, como hacen la mayoría de los procesadores de Markdown. Para protegerte, la vista previa nunca se inserta en esta página. Se muestra en un marco aislado que no puede ejecutar scripts, enviar formularios, abrir ventanas emergentes ni acceder a este sitio. Además, su política de seguridad de contenido bloquea scripts, hojas de estilo externas, fuentes y marcos. Una etiqueta <script> o un atributo onclick en tu Markdown aparece en el código fuente HTML, pero nunca se ejecuta. Los enlaces de la vista previa se muestran, pero no se abren; copia la URL si quieres visitarlos.
La vista previa usa una hoja de estilo neutra, similar a la de los lectores habituales de archivos README. Tu sitio web o GitHub pueden aplicar estilos distintos al mismo HTML. El HTML que copias es un fragmento sin estilos; el archivo .html descargado incluye una hoja de estilo básica para que se vea como la vista previa. El HTML descargado o copiado no se depura, así que, si contiene scripts, se ejecutarán donde lo pegues o abras.
Ejemplos
Revisar un README antes de subirlo
Pega README.md para comprobar que las columnas de la tabla estén alineadas, que la lista de tareas se muestre como casillas y que los bloques de código tengan los delimitadores correctos antes de subir el archivo a GitHub.
Escribir para un CMS que acepta HTML
Redacta una entrada de blog en Markdown y luego pulsa «Copiar HTML» para pegar las etiquetas <h2>, <p> y <ul> en el editor HTML del CMS.
Saltos de línea al estilo de un chat
El texto de una aplicación de chat tiene líneas separadas por saltos de línea simples. Activa «Tratar los saltos de línea simples como <br>» para mantener las líneas separadas en lugar de unirlas en un solo párrafo.
Preguntas frecuentes
¿Es seguro pegar Markdown de una fuente desconocida?
Sí, para ver la vista previa. El HTML generado se muestra en un marco aislado con los scripts desactivados, así que ni una etiqueta <script> ni un controlador de eventos incluido en el texto harán nada aquí. Ten cuidado al pegar el HTML exportado, porque no se depura.
¿Por qué no aparecen mis imágenes?
Las imágenes de otros sitios web se bloquean de forma predeterminada para que la vista previa no realice solicitudes de red. Activa «Cargar imágenes de otros sitios web» para mostrarlas. Las rutas relativas, como ./docs/screenshot.png, no funcionan porque esos archivos no están aquí.
¿Admite notas al pie, fórmulas o diagramas?
No. Es compatible con CommonMark y GitHub Flavored Markdown (tablas, listas de tareas, tachado y enlaces automáticos). Las notas al pie, las fórmulas LaTeX y los diagramas Mermaid son extensiones que esta vista previa muestra como texto sin formato.
¿Por qué un salto de línea simple no empieza una línea nueva?
En Markdown estándar, un salto de línea simple dentro de un párrafo se interpreta como un espacio. Termina la línea con dos espacios, deja una línea vacía o activa «Tratar los saltos de línea simples como <br>».
Privacidad
Markdown se convierte en tu navegador y no se sube ni se almacena. La vista previa no carga nada de Internet a menos que permitas imágenes de otros sitios web; en ese caso, las imágenes se solicitan directamente a sus servidores.