Softonic

Formateador de Markdown

Paso 1 / 2
Siguiente

Pega un documento Markdown y el formateador lo reescribe a un estilo consistente: corrige saltos de nivel de encabezado (sin H2 después de H4), rellena las columnas de la tabla para alinear en la fuente, impone una sola línea en blanco entre bloques, normaliza los marcadores de lista a -, colapsa series de líneas en blanco y ordena las definiciones de enlaces de estilo de referencia al final. El HTML renderizado no cambia, solo el archivo fuente se vuelve más ordenado, por lo que las diferencias se vuelven legibles.

Cómo el formateador reescribe Markdown

  1. 1

    Pega Markdown

    Suelta el documento en bruto, README, página de docs, notas de reunión.

  2. 2

    Elige opciones de estilo

    Marcador de lista (`-`/`*`), estilo de encabezado (ATX/Setext), alineación de tabla, columna de ajuste.

  3. 3

    Formatear

    La herramienta analiza el documento en un AST y lo re-serializa con el estilo elegido.

  4. 4

    Compara la salida

    Una vista en paralelo muestra qué cambió antes de que lo pegues de nuevo.

Lo que el formateador corrige

  • Marcadores de lista. *, -, + se normalizan a un carácter consistente (por defecto -).
  • Jerarquía de encabezados. Advierte (o promueve) cuando H2 es seguido por H4 sin H3 entre ellos.
  • Líneas en blanco. Exactamente una línea en blanco entre bloques; sin series de tres o más.
  • Tablas. Rellena cada columna para que las barras verticales se alineen en la fuente, aunque a los renderizadores de Markdown les dé igual.
  • Espacios en blanco finales. Elimina los espacios finales en cada línea excepto el marcador de salto de línea de dos espacios intencional.
  • Enlaces de referencia. Recoge definiciones de [label]: url al final del documento, ordenadas alfabéticamente.
  • Bloques de código. La etiqueta de lenguaje se normaliza a minúsculas; los bloques de código basados en indentación se convierten en bloques cercados.

Opciones de estilo que puedes establecer

Opción Predeterminado Alternativas
Marcador de lista - *, +
Estilo de encabezado ATX Setext para H1/H2
Delimitador de énfasis * _
Delimitador de negrita ** __
Columna de ajuste 0 (desactivado) 80, 100, 120
Ordenar enlaces de referencia activado desactivado

Por qué es importante un Markdown consistente

En un repositorio de equipo, un Markdown inconsistente produce diferencias ruidosas: cada vez que alguien guarda un archivo con un editor diferente, los marcadores de lista cambian y las tablas se reorganizan. Un formateador impone un estilo para que los revisores de los pull requests vean solo cambios de contenido. Piénsalo como prettier para prosa.

Cuándo no formatear

  • Bloques de código cercados permanecen intactos byte por byte, el formateador nunca tocará el contenido de un bloque de código. Si el formateo cambia el código, es un error.
  • Saltos duros intencionales a anchos estrechos (readme.md en un proyecto de terminal) se reenvuelven si habilitas la columna de ajuste. Desactiva el ajuste si mantienes saltos de línea ajustados a mano.
  • Bloques HTML incrustados pasan sin cambios.

Reemplazos directos

Si prefieres una CLI local, el formateador utiliza las mismas reglas de AST que remark-stringify con el plugin remark-gfm. prettier --parser markdown produce un resultado similar.

Preguntas frecuentes

No. El formateador reescribe solo la fuente, la salida HTML renderizada tanto antes como después debería ser equivalente. Si ves un cambio en la renderización, repórtalo como un error.

No. El front-matter YAML o TOML en la parte superior del archivo se detecta y se pasa sin cambios.

Sí, establece la columna de ajuste en 80, 100 o 120 y los párrafos se volverán a ajustar. Las líneas dentro de bloques de código nunca se tocan.

No. El formateador asume que tus enlaces funcionan; solo reorganiza las definiciones de enlaces de referencia. Usa una herramienta de verificación de enlaces por separado.

No. El análisis y el formateo se ejecutan en tu navegador; el contenido nunca sale de tu dispositivo.

Herramientas relacionadas

Referencia de la tabla ASCII

Tabla ASCII completa del 0 al 127 con decimal, hex, octal, binario y referencia numérica HTML para cada carácter, incluidos los códigos de control como NUL, LF y DEL.

Referencia de caracteres HTML

Lista buscable de entidades HTML, sus códigos nombrados y numéricos, y una copia con un clic para caracteres y símbolos especiales.

Referencia de atajos de teclado

Busca los atajos predeterminados documentados de VS Code, Chrome y Bash con GNU Readline en macOS, Windows y Linux.

Generador de letras aleatorias

Genera letras aleatorias A-Z. Elige la cantidad, usa mayúsculas, minúsculas o mezcla de ambas, y aplica el resultado en juegos, consignas o clase.

Generador de Paletas de Color

Genera paletas monocromáticas, análogas, complementarias, triádicas o tetrádicas desde un color base HEX y exporta variables CSS listas para copiar.

Generador de EditorConfig

Genera un archivo .editorconfig con tu estilo y tamaño de indentación, fin de línea, charset y reglas de espacios para un formato consistente en IDEs y editores.

Herramienta disponible en otros idiomas