Conversor de Markdown a WhatsApp

Convierte Markdown estándar a la sintaxis de formato de WhatsApp: como página web, biblioteca npm, herramienta de línea de comandos o servidor MCP para agentes.

➡️ Ir a la herramienta en vivo

npm i markdown-to-whatsapp · npx markdown-to-whatsapp mcp

Propósito de esta herramienta

WhatsApp utiliza una sintaxis no estándar para el formato de texto (p. ej., *negrita*, _cursiva_, ~tachado~). Es similar, pero no idéntica, al Markdown estándar.

Esta herramienta ofrece una forma sencilla de convertir texto de fuentes Markdown (editores de texto, Google Docs, etc.) al formato que espera WhatsApp, evitando la necesidad de corregirlo manualmente.

Todo el proceso de conversión se ejecuta localmente en tu navegador mediante JavaScript, y el analizador se incluye con la página. Ningún dato se envía jamás a un servidor: la única petición que sale de la página es la de la fuente.

Related MCP server: AI Group Markdown to Word MCP Server

Conversiones admitidas

El script utiliza la biblioteca marcada para un análisis adecuado basado en AST y gestiona:

Estilos de texto

• Negrita: **texto** → *texto*

• Cursiva: *texto* o _texto_ → _texto_

• Tachado: ~~texto~~ → ~texto~

• Código en línea: `código` → `código`

• Negrita+Cursiva: ***texto*** → _*texto*_ (conserva ambos estilos)

Encabezados

Los encabezados se convierten a texto en negrita con prefijos de emoji según el nivel:

• # H1 → *📌 H1*

• ## H2 → *🟠 H2*

• ### H3 → *🟡 H3*

• Y así sucesivamente...

El prefijo de emoji se puede desactivar en la interfaz (Encabezados · Emoji), dejando el título simple en *Título*.

Listas

• Listas desordenadas: utiliza el prefijo * con ◦ para los niveles anidados

  • Nivel 1: * Elemento

  • Nivel 2: * ◦ Elemento

  • Nivel 3: * ◦ ◦ Elemento

• Listas ordenadas: conserva la numeración, con ◦ marcando los niveles anidados

  • 1. A / ◦ 1. A1 / ◦ ◦ 1. A1a / 2. B

• Listas de tareas: - [x] → ☑, - [ ] → ☐, también dentro de listas ordenadas (1. ☑ hecho)

• Elementos sueltos: varios párrafos de un mismo elemento se unen en una sola línea

• Contenido en bloque dentro de elementos: los bloques de código, las citas y las listas anidadas se emiten en sus propias líneas debajo del elemento

Anchura de la burbuja

Una burbuja de WhatsApp admite un número fijo de caracteres monoespaciados por línea: unos 26 en un teléfono de 360 px, que es el valor por defecto. Mide la tuya enviándote un bloque de código a ti mismo y contando dónde se parte, y luego fija Anchura en la barra con ese valor (el ? al lado dice lo mismo). El campo acepta de 10 a 80: ningún teléfono queda fuera de ese rango.

El número es una propiedad del teléfono, no de ninguna tabla en particular, por lo que rige todo lo monoespaciado: las tablas se degradan para mantenerse por debajo de él, y la vista previa dibuja cada bloque de código exactamente con esa anchura, ajustando donde se ajustará el WhatsApp del destinatario.

Tablas

Una tabla se representa en dos estilos, elegidos en la interfaz para todo el documento o para una sola tabla a la vez:

1. Automático (por defecto): una tabla dibujada dentro de un bloque monoespaciado, tan ancha como sea necesario y nunca más ancha que la burbuja — y la lista con viñetas cuando no se puede dibujar ninguna caja.

   +--------+-------------+
   | Name   | Description |
   +========+=============+
   | Value  | Details     |
   +--------+-------------+

2. Lista: siempre la lista con viñetas.

Cómo se distribuye la lista

Una lista puede agrupar las celdas de tres maneras. El conversor deduce automáticamente a partir de los encabezados y las celdas en negrita, y esa suposición se puede anular tabla por tabla (Distribución: Automático · Filas · Columnas · Parejas):

• Parejas — 2 columnas, sean cuales sean los encabezados: cada fila es una línea de clave: valor. Escribir los encabezados completos en cada fila se lee peor que Italia: Roma en casi cualquier tabla.

  * *CPU:* Intel Xeon
  * *RAM:* 64 GB
  * *Storage:* 1 TB SSD

• Columnas — 3 o más columnas cuyo primer encabezado está vacío o nombra una propiedad ("Característica", "Spec", "Parámetro"...), o cuya primera columna está en negrita: una matriz de comparación, donde las cosas comparadas son las columnas, así que cada columna se convierte en un grupo.

  * *Proxmox*
  * ◦ _Kernel:_ KVM
  * ◦ _License:_ AGPL v3
  * *ESXi*
  * ◦ _Kernel:_ VMkernel
  * ◦ _License:_ Proprietary

• Filas — todo lo demás: un grupo por fila, etiquetado por su primera celda.

  * *Product:* Laptop
  * ◦ _Price:_ $999
  * ◦ _Stock:_ 50
  * *Product:* Smartphone
  * ◦ _Price:_ $599
  * ◦ _Stock:_ 100

Las palabras de propiedad se comparan palabra por palabra ("Especie" no cuenta como "spec") en 11 idiomas: inglés, italiano, español, francés, portugués, alemán, ruso, árabe, hindi, bengalí e indonesio. Las parejas necesitan exactamente dos columnas; si se piden en una tabla más ancha, se interpreta como Filas.

Cómo se degrada la caja

La caja no se dibuja con cualquier ancho: se degrada hasta caber en monoWidth, y se convierte en una lista cuando nada cabe. No hay forma de pedir una tabla más ancha que la burbuja.

1. Caja completa, eliminando el relleno columna a columna (primero por la derecha, luego por la izquierda).

2. Estilo compacto sin bordes, de nuevo eliminando el relleno de forma progresiva:

    Head1|Head2       |Head-N
   ------+------------+------
    A    |BBBBBBBBBBBB|C

3. Caja con ajuste, primero con bordes completos y luego compacta: cada columna recibe al menos su palabra más larga, el ancho restante se distribuye proporcionalmente y las celdas se ajustan. Las filas crecen tanto como necesiten — no hay límite — y siempre se dibuja una regla entre ellas, porque dos filas ajustadas sin ella se mezclan. Las celdas se alinean a la parte superior de su fila.

   +---------+--------------+
   | Feature | Notes here   |
   +=========+==============+
   | Alpha   | short note   |
   +---------+--------------+
   | Beta    | a slightly   |
   |         | longer note  |
   +---------+--------------+

4. Lista con viñetas, cuando ni siquiera las palabras más largas caben (una URL larga, cinco columnas a 26 caracteres…).

Si una caja ajustada y alta se lee mejor que la lista es un juicio que la vista previa te permite hacer: el panel propio de esa tabla la cambia a Lista. Una tabla que no puede alojar ninguna caja lo indica en su panel y ofrece la distribución de lista en lugar de un estilo que no podría cambiar nada.

Comportamiento adicional de las tablas

• Los anchos de columna se miden en celdas de visualización, por lo que los emojis y el texto CJK se alinean (✅, 日本語 cuentan como dos columnas) — en la medida en que el teléfono lo permita: esos símbolos vienen también de una fuente de reserva, así que la alineación es lo mejor posible, a diferencia de los bordes ASCII.

• La alineación de columnas (:---, :---:, ---:) se respeta en los estilos de caja y compacto.

• Las tablas de solo encabezado se renderizan sin cuerpo vacío ni borde duplicado.

• <br> dentro de una celda se convierte en un espacio, y una barra vertical con escape \| se convierte en ¦ para que no pueda simular una columna de más.

• Los bordes son ASCII plano (+|-), a propósito. La fuente monoespaciada de WhatsApp no tiene glifos de dibujo de cajas: un teléfono toma ─ y ┌ de cualquier fuente de reserva que tenga, con el ancho que esa fuente les dé, y una línea de 26 de ellas se envuelve en dos líneas, mientras que las filas de texto a su lado no lo hacen. +- son los únicos caracteres cuyo ancho una fuente monoespaciada realmente promete — que es también por eso que la barra escapada se convierte en ¦, un carácter latino-1 de la misma fuente que à.

• El separador de filas (desactivado por defecto) dibuja una regla entre las filas del cuerpo, en todos los estilos de caja y compactos; una tabla ajustada lo dibuja independientemente.

• La estilo, el separador de filas y la distribución de la lista se pueden configurar por tabla: al pasar el ratón sobre una tabla de la vista previa aparecen sus propios controles, que parten de ajuste por defecto del documento y lo sustituyen solo para esa tabla, mostrando únicamente los que siguen siendo relevantes (el separador en una caja, la distribución en una lista). La anchura no está entre esas opciones: hay una sola burbuja y es la misma para todas las tablas. Una tabla con sus propias configuraciones mantiene une marca discontinua, ya que los controles de la parte superior del panel deliberadamente no la modifican — su botón "restablecer" se la devuelve a ellos. Las anulaciones siguen a la tabla por el texto de su encabezado, de modo que añadir o eliminar una tabla más arriba no las desplaza. Una tabla anidada dentro de un elemento de lista o una cita sigue siempre la configuración predeterminada del documento.

Bloques de código

Los bloques delimitados e indentados llegan a WhatsApp tal cual: el conversor nunca los reajusta ni reindenta, porque un salto de línea dentro del código es contenido, no estructura. WhatsApp envuelve las líneas largas por sí solo, a mitad de palabra, y una burbuja de chat no tiene desplazamiento horizontal — por lo que la vista previa reproduce ese ajuste a monoWidth en lugar de desplazarse y muestra exactamente donde el destinatario verá el corte.

Otros elementos

• Enlaces: [texto](url) → texto (url); los enlaces automáticos, <https://x.com>, [url](url) y <me@x.com> se muestran como la URL o dirección desnuda (sin duplicados ni fugas mailto:)

• Entidades HTML: referencias decimales y hexadecimales además de las comunes con nombre — letras latino-1, puntuación y símbolos (café → café, ©; A → A). Las referencias más raras (griegas y matemáticas) se dejan tal cual.

• HTML en línea: <b>/<strong> → *, el <i>/<em> → _, <s>/<del> → ~, <code> → `; <br> → nueva línea; los comentarios y otras etiquetas se eliminan

• Bloques HTML: las etiquetas se eliminan, los límites de los bloques se convierten en nuevas líneas y las entidades se decodifican

• Citas: conserva el prefijo >, admite anidamiento (> > citada)

• Bloques de código: se conservan con triple comilla invertida; una triple comilla invertida dentro del contenido se sustituye por ˋˋˋ para que no pueda cerrar el bloque prematuramente

• Línea horizontal: --- → ───────────────

• Caracteres de escape: utiliza sustitutos Unicode parecidos (∗, ＿, ∼) para que WhatsApp no los interprete como formato

Gestión específica de WhatsApp

• El formato parcial de palabras se ignora: super**bold**ly → superboldly (WhatsApp no admite formato a mitad de palabra)

• La puntuación es un límite válido: **Nombre**: valor de → *Name*: value, y también lo son (**x**) y **fin**.

Cómo usarlo

1. Abre la página web: https://drsound.github.io/markdown-to-whatsapp/

2. Pega, escribe o suelta un archivo .md en el panel izquierdo. "Probar con un ejemplo" la rellena con un mensaje de muestra.

3. El panel derecho muestra el mensaje en una burbuja de WhatsApp, tal cual lo verá el destinatario; "ver sintaxis sin procesar" muestra el texto que se copiará. Los dos paneles se desplazan juntos — el que esté bajo el cursor dirige — y mientras escribes, la vista previa sigue al cursor.

4. "Copiar para WhatsApp", o "Compartir en WhatsApp" para abrir un chat con el mensaje listo mediante wa.me. Los mensajes muy largos no caben en un enlace — los navegadores cortan las URL a partir de unos pocos miles de caracteres — así que "Compartir" se retira y sugiere copiar.

La interfaz sigue el tema claro u oscuro del sistema operativo; la alternancia de la cabecera lo anula y esa elección se recuerda. La barra de opciones tiene una sección por tipo de contenido, cada una visible solo mientras el texto lo contiene: Burbuja (la anchura, cuando hay una tabla o un bloque de código), Tablas (estilo y separador) y Encabezados (el prefijo de emoji). Un control que otra configuración convierte en inútil — el separador en estilo "Lista", la anchura sin nada monoespaciado que dibujar — se atenúa in situ en lugar de eliminarse, de modo que la barra mantenga su forma. Las opciones se guardan en localStorage junto con el tema. Las opciones de cada tabla no se guardan: pertenecen al texto que se convierte.

Uso desde el código, la terminal o un generador de contenido

El mismo convertidor se publica en npm con el nombre markdown-to-whatsapp (Node 20 o posterior). Las opciones son las descritas anteriormente, con los mismos nombres y valores por defecto, y se enumeran completas al final de esta sección.

Biblioteca

npm install markdown-to-whatsapp

import { convertTextToWhatsapp, convertToBlocks } from 'markdown-to-whatsapp';

convertTextToWhatsapp('# Hi **there**');
// → '*📌 Hi there*'

convertTextToWhatsapp(markdown, { monoWidth: 30, tableFormat: 'auto', headingEmojis: false });

// The same conversion with the blocks kept apart: each has the source `line` it starts on,
// and each table its `key`, `columns`, `fitsBox`, `asList` and `listLayout`
const { text, blocks } = convertToBlocks(markdown, { monoWidth: 30 });

Línea de comandos

npx markdown-to-whatsapp notes.md                  # a file…
cat notes.md | npx markdown-to-whatsapp            # …or stdin
npx markdown-to-whatsapp notes.md --width 32 --tables list --no-emoji
npx markdown-to-whatsapp notes.md --json           # the blocks, for scripting
npx markdown-to-whatsapp --help

--width (10–80), --tables auto|list, --layout auto|rows|columns|pairs, --separator, --no-emoji, --json, además de -h, --help y -v, --version. La salida va a stdout; una opción incorrecta explica el porqué en stderr y sale con código 2.

Servidor MCP

El paquete se ejecuta como un servidor de protocolo Model Context sobre stdio, de modo que un generador pueda convertir texto por sí mismo — algo importante en las tablas: contar columnas frente a una burbuja de 26 caracteres es lo que el modelo hace mal y esta herramienta hace bien.

claude mcp add markdown-to-whatsapp -- npx -y markdown-to-whatsapp mcp

o, para Claude Desktop y otros clientes que admiten una configuración JSON:

{
  "mcpServers": {
    "markdown-to-whatsapp": {
      "command": "npx",
      "args": ["-y", "markdown-to-whatsapp", "mcp"]
    }
  }
}

Expone una única herramienta, convert_markdown_to_whatsapp, que recibe markdown y los opcionales monoWidth, tableFormat, listLayout, rowSeparator y headingEmojis. El texto se devuelve como contenido de la herramienta, y el resultado estructurado lo lleva como text, junto con tables: una entrada por tabla, con key, columns, fitsBox, asList y listLayout, para que el agente pueda saber qué tablas acabaron siendo una caja y cuáles una lista. La herramienta es de solo lectura e idempotente.

Opciones

Las opciones son tableFormat (auto | list), monoWidth, rowSeparator, headingEmojis, listLayout (auto | rows | columns | pairs) y tableOverrides: ya sea un array indexado por la posición de la tabla en el documento o un objeto indexado por la key de la tabla (sus textos de encabezado unidos con |, más #2, #3… para encabezados repetidos), and cada entrada anula cualquira de la demás únicamente para la esa tabla. La página expone listLayout únicamente per tabla.

Los nombres anteriores se siguen aceptando en la entrada: tableThreshold por monoWidth, y ascii / always para tableFormat (ascii nunca dibujó una caja más ancha que el globo, así que se asigna a auto). Cuando se proporción both the old and the new name, the new one, the old is dropped. borderStyle, que solía elegir el dibujo de cajas con Unicode, se accepta y se ignora.

Development

Running the tests

Node 20 or above, from the root of the repository:

npm install
npm test

The test suite uses a valid version:

• tests/inputs/*.md - Markdown input files

• tests/inputs/*.json - optional converter options per fixture (e.g. { "monoWidth": 4 })

• tests/expected/*.txt - Expected Whatsapp output

adás de algunos invariants: el análisis de la vendor coincides with the installed one, convertToBlocks reports the correct source lines, and the entry point of the package is the page script.

Las pruebas also/correr en CI en cada push and pull request (.github/workflows/test.yml).

Standard structure

• docs/converter.js: the converter itself: a pure ES module, sin DOM, with the options passed as a parameter. It is at the same time the script that the page imports and the entry point of the npm package (exports["."]), so there is one copy and no build step. Exposes convertToWhatsapp(markdown, options), convertToBlocks(markdown, options) — the same conversion but with the top-level blocks separated and each one tagged with the block it is for, which is what the per-table options are built on — and the mdContainsTable / mdContainsHeading / mdContainsCode queries that the UI uses to show an option only when it applies. In convertToBlocks, all the blocks with the line source from which it starts — what keeps the two panels in sync — and each table block also its key, columns, fitsBox (if a box is possible), does. Each entry as listLayout, so that the interface can offer exactly the choices left.

• docs/ui.js - page wirings: theme, contextual options, WhatsApp preview, scroll sync between panels, copy and share

• docs/index.html, docs/style.css - markup and hand-written style, no CSS framework

• docs/vendor/ - the ES build of marked, copied from node_modules by npm run build; the page's map imports marked into it

• bin/markdown-to-whatsapp.js - the command-line tool; bin/mcp.js - the MCP server, loaded only then, so converting a file never loads the protocol SDK

• scripts/vendor.js - copys the ES build of marked to /vendor (npm run vendor)

• tests/ - the fixtures and the runner

La dep encia de marked

The version of marcado is fixed at 18.0.0 in package.json, and the copy that the page loads from docs/vendor/ is checked against it by the test suite, so that the page, the package and the tests always mark the same Markdown. To update it: change the fixed version, npm install, npm run .`.,

in

npm test
npm pack --dry-run   # docs/converter.js, bin/, README, LICENSE — nothing else
npm publish

Local development

cd docs
python3 -m http.server 8080
# Open http://localhost:8080

Licencia

MIT, consulta el archivo LICENSE.