Word a Markdown Guía de formato: Preserva todos los estilos

El formato es donde la mayoría de las conversiones Word-a-Markdown van mal. El texto en negrita se muestra como texto sin formato. Las mesas se derrumban. Los encabezados se convierten en párrafos sin estilo. Esta guía explica exactamente lo que sucede durante Word a Markdown la conversión y cómo controlar la salida.

Comprender el proceso de conversión

Cuando se convierte un documento Word a Markdown, suceden dos cosas:

1. Se trata de una serie de medidas de protección contra la contaminación por gases de efecto invernadero y gases de efecto invernadero, incluidas las medidas de protección contra la contaminación por gases de efecto invernadero y gases de efecto invernadero. mamut.js analiza el Word XML y asigna cada elemento a HTML
2. Se trata de una serie de medidas que se aplican en el ámbito de la protección de los derechos de autor. Turndown convierte la sintaxis HTML a Markdown

El segundo paso no tiene pérdidas si el HTML está limpio. El primer paso es donde la complejidad de formato importa Words los estilos necesitan mapear a los equivalentes HTML conocidos.

Utilización Convertidor de WordToMDs Para ver exactamente cómo su documento se convierte en tiempo real.

Estilos de encabezado

La decisión de formato más importante en Word es el uso de estilos de encabezado incorporados.

Error común: Formatear manualmente el texto en tamaño grande y en negrita en lugar de aplicar un estilo de encabezado. Esto se parece a un encabezado en Word pero convierte en texto en negrita en Markdown, no ##.

Para la referencia completa de las partidas, véase Markdown Guía de encabezados.

El énfasis del texto

El subrayado y el resaltado no tienen equivalente Markdown en la sintaxis estándar. Después de la conversión, use HTML <u> etiquetas o clases CSS personalizadas si su plataforma de publicación las admite.

Las listas

El formato de lista automático de Word se convierte limpiamente:

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

Lo que rompe las listas: Los guiones o números escritos manualmente que no son elementos reales de la lista Word. Estos se parecen a listas visualmente pero Word los trata como párrafos de texto plano. La solución: seleccionalas en Word y aplica el estilo Bullet de lista o Número de lista.

Las tablas

Las tablas estándar se convierten en GitHub con sabor Markdown sintaxis de la tabla:

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

Lo que rompe las tablas:

• Celdas fusionadas la celda que abarca varias columnas o filas se colapsará
• Contenido de celdas de varias líneas Se eliminan las roturas de línea dentro de las celdas
• Tablas anidadas la tabla interior está aplanada hasta convertirse en texto plano

Para un desglose completo, véase Markdown Tablas: una guía completa.

Código y texto preformateado

Texto formateado con una fuente monospacio (Courier New, Consolas) en mapas Word a código en línea:

Use `console.log()` to debug.

Para bloques de código cercados con resaltado de sintaxis, aplique Words Code estilo de párrafo si su plantilla tiene uno, o añadir la triple valla trasera manualmente después de la conversión. No se puede hacer. Markdown Guía de bloques de código para la sintaxis completa.

Los hipervínculos

Word Los hipervínculos se convierten perfectamente:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

El texto del enlace y la URL se conservan. Los marcadores (enlaces internos dentro del mismo documento) pueden no convertirse si el objetivo no existe en Markdown.

Imágenes

Las imágenes son donde la conversión de Word a Markdown siempre se queda corta. mammoth.js puede extraer imágenes incrustadas como base64 URI de datos, pero el comportamiento predeterminado es anotar su presencia en las notas de conversión. Después de la conversión:

1. Exportación de imágenes desde Word: Archivo → Guardar como → Página web (HTML)
2. Hacer referencia a ellos en Markdown: ![Alt text](path/to/image.png)

Personajes y símbolos especiales

Word a menudo inserta caracteres especiales de Unicode automáticamente:

• Las cotizaciones inteligentes ("...") → conservado como caracteres Unicode
• No , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no , no .—) → conservado
• Espacios no rotativos → convertidos en espacios regulares
• Símbolo de los derechos de autor (©) → conservado

Si necesita una salida solo en ASCII, haga una búsqueda y reemplazo en su editor de texto después de la conversión.

Estilos Word personalizados

Si su documento de Word utiliza estilos de párrafo personalizados (como Callout o Warning), mammoth.js los registra como notas de conversión. Verá mensajes como Estilo de párrafo no reconocido: Callout. WordToMD filtra estos mensajes informativos por defecto.

Para manejar estilos personalizados, usted necesita una configuración local Pandoc con un filtro personalizado ver Pandoc, mensaje para Markdown. para ese enfoque.

Lista de verificación de formato antes de convertir

Aplique esta lista de verificación a su documento Word antes de convertir:

• Todos los encabezados usan Words estilos de encabezado 1/2/3 incorporados (no de formato manual)
• Las listas se crean con las herramientas de lista Words (no se escriben guiones/números)
• Las tablas son rejillas simples (sin celdas fusionadas)
• El código utiliza una fuente monospacio
• Los hipervínculos son hipervínculos reales (no sólo texto subrayado en azul)

FAQ

¿Por qué mis encabezados se convierten en texto en negrita? Aplicó el formato en negrita + tamaño de fuente manual en lugar del estilo de encabezado. En Word, haga clic en el párrafo y mire el panel de estilos debería decir Título 1 no Normal.

Mi lista numerada se reinició en 1 en el lugar equivocado ¿Cómo puedo arreglarlo? Establecer la continuación de la lista en Word: haga clic con el botón derecho en la lista → Continuar la numeración. O editar el Markdown directamente después de la conversión.

La alineación de la mesa se ve mal en Markdown. - ¿Qué pasó? - ¿Qué pasó? Uso de las tablas GFM |---| para los separadores de alineación. WordToMD genera estos automáticamente. Si el renderizado no parece correcto, compruebe que ninguna celda tenga caracteres de pipa (|) en su contenido escapar de ellos como \|.

Conclusión

Me estoy limpiando. Formación de Word a Markdown se trata principalmente de usar Word correctamente. Aplique los estilos de encabezado incorporados, use las herramientas de lista y tabla Words, y obtendrá una salida casi perfecta de la Convertidor de WordToMD. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.