Cómo usar el visor de Markdown en vivo
- En un ordenador, escribe Markdown en el cuadro de la izquierda y el documento aparece a la derecha al momento. En el móvil, usa las pestañas de arriba para elegir «Editar», «Vista previa» o «Apilado».
- Si es tu primera vez, pulsa primero «Ejemplo» para ver ejemplos de títulos, listas, tablas y bloques de código. Edítalos y observa cómo cambia el resultado.
- Cuando termines, usa «Copiar HTML» para llevarte el HTML convertido, o «Descargar HTML» y «Descargar MD» para guardar archivos.
- Si los saltos de línea se juntan en una sola línea, activa «Conservar los saltos de línea». El recuento de caracteres y palabras se muestra abajo a la derecha.
Cómo funciona la conversión
Cada vez que escribes se dispara un evento de entrada y el analizador incorporado en esta herramienta lee tu texto línea a línea y lo convierte en HTML. Primero encuentra bloques como bloques de código, títulos, líneas horizontales, tablas, citas y listas, y luego trata la sintaxis en línea, como negrita, cursiva, enlaces, imágenes y código en línea dentro de los párrafos. El resultado se muestra en la vista previa y el botón Copiar HTML te da el mismo contenido.
No se carga ninguna biblioteca de conversión externa; todo se ejecuta dentro de esta página. Eso la mantiene rápida incluso con una conexión lenta y nada de lo que escribes sale de tu dispositivo. Las etiquetas HTML de tu texto se convierten primero en texto, así que los scripts nunca se ejecutan, y los enlaces solo admiten direcciones seguras.
Sintaxis de Markdown de uso habitual
Markdown sirve no solo para documentos de desarrollo, como los README, sino también para borradores de blog, actas de reuniones, listas de tareas y apuntes de estudio donde quieres una estructura ligera. Puedes crear títulos y listas con el teclado sin buscar botones de formato, y, como el archivo es texto sin formato, se abre en cualquier dispositivo sin estropearse y funciona bien con el control de versiones y la búsqueda. Por eso mucha gente escribe borradores en Markdown y los pasa a HTML o a documentos cuando hace falta.
Los títulos empiezan con entre uno y seis caracteres #, la negrita es **texto**, la cursiva es *texto* y el tachado es ~~texto~~. Una línea que empieza con - o * se convierte en una lista con viñetas y 1. 2. 3. en una lista numerada. Sangrar dos o cuatro espacios crea una lista anidada, y - [ ] y - [x] se muestran como una lista de tareas.
Los enlaces son [texto](dirección) y las imágenes son . Rodear el código con una sola comilla invertida crea código en línea, y tres comillas invertidas arriba y abajo crean un bloque de código. Añadir un lenguaje como js, python, json, css o html en la primera línea colorea las palabras clave, las cadenas, los números y los comentarios. Para las tablas, separa las celdas con | y pon --- en la segunda línea; :---, :---: y ---: cambian la alineación.
Las reglas de Markdown difieren un poco entre servicios. Un estilo habitual es el Markdown de GitHub, que añade tablas y listas de tareas al estándar CommonMark, y esta herramienta muestra un resultado parecido. Detalles como los saltos de línea y las listas anidadas aún pueden diferir, así que comprueba un documento importante en la vista previa del servicio donde lo vayas a publicar.
Consejos para obtener buenos resultados
- Pon siempre un espacio después de # en un título. «#Título» sin espacio no se reconoce como título.
- Deja una línea en blanco para empezar un párrafo nuevo. Un solo salto de línea se queda en el mismo párrafo.
- Sin la segunda fila de --- la tabla se muestra como texto sin formato.
- Guarda de vez en cuando los textos largos con Descargar MD. Al cerrar la página se borra todo.
- Antes de pegar el HTML copiado en un blog o un aviso, comprueba que el servicio admite esas etiquetas.
Preguntas frecuentes
¿Qué es Markdown?
Markdown es una forma de escribir con símbolos sencillos como #, ** y - para marcar títulos, texto en negrita y listas. Escribes texto sin formato que puede convertirse en un documento HTML, por lo que se usa mucho en documentación para desarrolladores, blogs y aplicaciones de notas.
¿Qué sintaxis admite?
Títulos, negrita, cursiva, tachado, código en línea, bloques de código, citas en bloque, listas ordenadas y sin ordenar, listas de tareas, tablas, enlaces, imágenes y líneas horizontales. No admite extensiones como notas al pie, fórmulas matemáticas ni códigos abreviados de emoji.
¿Qué pasa con las etiquetas HTML o los scripts de mi texto?
Las etiquetas HTML de tu texto no se ejecutan y se muestran como texto sin formato. Los enlaces solo admiten direcciones http, https, mailto y tel, y las peligrosas, como javascript:, se bloquean.
¿El resultado puede diferir del de GitHub u otros servicios?
Sí. Las reglas de Markdown difieren ligeramente entre servicios, así que los saltos de línea, las listas anidadas y las extensiones pueden verse distintos. Piensa en esta herramienta como un conversor ligero para la sintaxis de uso habitual.
¿Se guarda mi texto?
No. No se almacena en un servidor ni en tu navegador. Desaparece al cerrar la página, así que usa Descargar MD para conservar un archivo de lo que necesites.
Notas y limitaciones
Esta herramienta es un conversor ligero para la sintaxis de Markdown de uso habitual y no coincide exactamente con la representación de todos los servicios. Lo que escribes se procesa solo en tu navegador y nunca se envía ni se guarda. BTSPACE WAGLE es un sitio de información no oficial; al usar en otro lugar el HTML convertido, comprueba las reglas de ese servicio.