Markdown-Docx: convierte archivos Markdown a formato DOCX y descárgalos 157

¿Qué es markdown-docx?

markdown-docx es una herramienta que se utiliza para convertir archivos Markdown a formato DOCX, compatible con los entornos de navegador y Node.js, y que admite una conversión de alta fidelidad.

Funciones principales de markdown-docx

• Conversión de alta fidelidad: capaz de convertir archivos Markdown a formato DOCX con una gran precisión.

• Soporte de imágenes: admite la descarga y el procesamiento automático de imágenes durante la conversión.

• Soporte de elementos Markdown: es compatible con diversos elementos de Markdown, como tablas, listas y bloques de código.

• Hipervínculos y notas al pie: permite conservar hipervínculos y notas al pie en el DOCX resultante.

• Personalización de estilos: ofrece opciones de estilo configurables.

<

• Compatibilidad con múltiples entornos: se puede utilizar tanto en el entorno del navegador como en el entorno de Node.js.

• Interfaz de línea de comandos: incluye una herramienta CLI para un uso cómodo.

Instalación de Markdown-Docx

Se puede instalar usando npm, yarn y pnpm:

# 使用 npm
npm install markdown-docx
# 使用 yarn
yarn add markdown-docx
# 使用 pnpm
pnpm add markdown-docx

Uso básico

Entorno Node.js

import fs from 'node:fs/promises';
import markdownDocx, { Packer } from 'markdown-docx';
async function convertMarkdownToDocx() {
  const markdown = await fs.readFile('input.md', 'utf-8');
  const doc = await markdownDocx(markdown);
  const buffer = await Packer.toBuffer(doc);
  await fs.writeFile('output.docx', buffer);
  console.log('Conversion completed successfully!');
}
convertMarkdownToDocx();

Entorno del navegador

import markdownDocx, { Packer } from 'markdown-docx';

async function convertMarkdownToDocx(markdownText) {
  const doc = await markdownDocx(markdownText);
  const blob = await Packer.toBlob(doc);
  const url = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = 'document.docx';
  a.click();
  URL.revokeObjectURL(url);
}

document.getElementById('convert-btn').addEventListener('click', () => {
  const markdown = document.getElementById('markdown-input').value;
  convertMarkdownToDocx(markdown);
});

Uso avanzado

Puedes utilizar la clase MarkdownDocx para un control más preciso:

import { MarkdownDocx, Packer } from 'markdown-docx';
import fs from 'node:fs/promises';
async function convertWithOptions() {
  const markdown = await fs.readFile('input.md', 'utf-8');
  const converter = new MarkdownDocx(markdown);
  const doc = await converter.toDocument({
    title: 'My Document',
    creator: 'markdown-docx',
    description: 'Generated from Markdown'
  });
  const buffer = await Packer.toBuffer(doc);
  await fs.writeFile('output.docx', buffer);
}

Se admiten opciones de configuración personalizadas, por ejemplo:

• imageAdapter: función personalizada para el procesamiento de imágenes

• ignoreImage: ignorar las imágenes en el Markdown

• ignoreFootnote: ignorar las notas al pie

• ignoreHtml: ignorar el HTML en línea

• gfm: compatibilidad con GitHub Flavored Markdown

Herramienta de línea de comandos

Puedes usar la herramienta CLI instalada globalmente para convertir archivos:

# 全局安装
npm install -g markdown-docx

# 基础用法
markdown-docx --input input.md --output output.docx

# 简写形式
markdown-docx -i input.md -o output.docx

Guía de uso de Markdown-Docx

• Pega el contenido en formato Markdown en el área de edición de la izquierda.

• El área de la derecha muestra una vista previa en tiempo real.

• Haz clic en el botón "Download Docx" situado en la esquina superior derecha del navegador y, en la ventana emergente, rellena la información básica del documento para descargar el archivo DOCX.

Github：https://github.com/vace/markdown-docx

Demo de demostración：https://md-docx.vace.me/