Inicio › Herramientas para desarrolladores › Formateador de Markdown

Formateador de Markdown

Pega Markdown desordenado y obtén una salida limpia y coherente con Prettier: encabezados, listas y énfasis normalizados, tablas alineadas y ajuste de línea opcional. Revisa el resultado en la vista previa en vivo y luego cópialo o descárgalo.

Última actualización:

Cargando el formateador Prettier…

Consejo: pulsa Ctrl + Intro para formatear. El formato usa Prettier y se ejecuta íntegramente en tu navegador; tu texto nunca se sube.

Publicidad
Publicidad

Cómo usar Formateador de Markdown

  1. Pega tu Markdown en la entrada, abre un archivo .md o carga el ejemplo desordenado.
  2. Elige el estilo: ajuste de texto y ancho de impresión, marcador de viñetas, tablas alineadas o compactas, y si formatear los bloques de código.
  3. Pulsa Formatear Markdown (o Ctrl + Intro). Con Formatear mientras escribo activado, la salida se actualiza mientras editas.
  4. Cambia a Vista previa para ver el resultado renderizado y comprobar que nada cambió de significado.
  5. Copia o descarga el Markdown formateado, o pulsa Usar la salida como entrada para seguir editando.

Antes y después: qué normaliza el formateador

EntradaFormateadoPor qué
Title
=====
# TitleLos encabezados ATX son más fáciles de leer y editar que los subrayados (Setext).
### Notes ###### NotesLas almohadillas de cierre son opcionales y se eliminan.
* item / + item- itemUn solo marcador de viñeta en todo el documento (configurable).
*emphasis*, __bold___emphasis_, **bold**Delimitadores de énfasis coherentes.
***---Separador temático coherente.
Tres líneas en blancoUna línea en blancoLas líneas en blanco extra no tienen efecto al renderizar.
|a|b|
|-|-|
| a | b |
| --- | --- |
Las columnas de tabla alineadas son legibles en texto plano.

Ajuste de texto: qué opción elegir

  • Conservar (la opción predeterminada de Prettier) mantiene los saltos de línea existentes dentro de los párrafos. Elígela si no quieres ningún reajuste.
  • Ajustar al ancho de impresión reajusta los párrafos a 80 caracteres (o al ancho que elijas). Ideal para documentos que se leen en terminales y para texto plano estilo correo.
  • Una línea por párrafo elimina los saltos de línea forzados. Muchos equipos lo prefieren para los README y los sitios de documentación, porque al editar una frase solo cambia una línea, y los editores ajustan el texto de todos modos.

Markdown también tiene saltos de línea forzados: una línea que termina en dos espacios o en una barra invertida fuerza un <br>. El formateador conserva ambas formas exactamente como están escritas, así que la salida renderizada no cambia. Como los espacios finales son invisibles, la barra invertida es la opción más segura para documentos nuevos.

¿Necesitas crear una tabla primero? Usa el Generador de tablas Markdown, o escribe y previsualiza documentos en el Editor de Markdown.

Preguntas frecuentes

¿Qué cambia el formateador de Markdown?

Reescribe el documento con un estilo coherente: encabezados # en lugar de subrayados, - para las listas con viñetas (o el marcador que elijas), _ para el énfasis y ** para la negrita, una línea en blanco entre bloques, caracteres especiales escapados donde haga falta, listas anidadas reindentadas y columnas de tablas alineadas. El significado renderizado del documento sigue siendo el mismo.

¿Reajustará mis párrafos?

Solo si lo pides. Conservar mantiene tus saltos de línea, Ajustar al ancho de impresión reajusta los párrafos al ancho elegido, y Una línea por párrafo une cada párrafo en una sola línea, lo que funciona bien con los diffs de git en algunos flujos de trabajo y con editores que ajustan el texto automáticamente.

¿La salida es la misma que al ejecutar Prettier?

Sí en el formato principal, ya que la herramienta ejecuta el printer de Markdown de Prettier 3 con las opciones mostradas. Hay dos opciones extra: la elección del marcador de lista y las tablas compactas se aplican después de Prettier, porque Prettier siempre usa - y tablas alineadas.

¿Admite GitHub Flavored Markdown?

Sí. Las tablas, las listas de tareas (- [ ] y - [x]), el tachado, los enlaces automáticos y los bloques de código delimitados se reconocen y se conservan. El front matter YAML al principio del archivo se mantiene tal cual.

¿Por qué se renumeran mis listas numeradas?

Prettier sigue tus dos primeros elementos: si la lista empieza con 1. 2., numera de forma incremental, y si empieza con 1. 1., usa 1. para todos los elementos, lo que mantiene pequeños los diffs al insertar elementos. Los renderizadores de Markdown numeran los elementos correctamente en ambos casos.

¿Se sube mi texto?

No. Prettier, el analizador de Markdown y el renderizador de la vista previa son archivos JavaScript que se ejecutan en la pestaña de tu navegador. Tu texto nunca sale del dispositivo.

¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?

Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.

Herramientas relacionadas

Ver todas las de Formateadores y validadores de código →