markdown-to-docx
Convierte archivos Markdown a DOCX con formato profesional usando pandoc. Incluye portada con título, tabla de contenidos, cabeceras y estilos corporativos. Usar cuando se necesite generar documentos Word desde Markdown, exportar documentación, o crear informes en formato .docx.
When & Why to Use This Skill
This Claude skill enables the seamless conversion of Markdown files into professionally formatted DOCX documents using Pandoc. It automates the creation of title pages, tables of contents, and corporate-styled headers, making it an essential tool for developers and technical writers who need to export high-quality Word reports and documentation from plain text sources while maintaining consistent branding.
Use Cases
- Technical Documentation: Transform project READMEs or technical specifications into polished Word documents for stakeholders and clients.
- Corporate Reporting: Generate formal business reports with automated covers, indices, and headers directly from Markdown notes.
- Standardized Publishing: Apply consistent corporate styles and typography to documents by utilizing custom DOCX templates during the conversion process.
- Knowledge Management: Export internal wiki pages or knowledge base articles into portable, editable Word formats for offline distribution.
| name | markdown-to-docx |
|---|---|
| description | Convierte archivos Markdown a DOCX con formato profesional usando pandoc. Incluye portada con título, tabla de contenidos, cabeceras y estilos corporativos. Usar cuando se necesite generar documentos Word desde Markdown, exportar documentación, o crear informes en formato .docx. |
Markdown a DOCX
Convierte archivos Markdown a documentos Word (DOCX) con formato profesional.
Características
- Portada con título: Genera portada automática con título, autor y fecha
- Tabla de contenidos: Índice automático con profundidad configurable
- Cabecera en páginas: Configurable en la plantilla
- Código con fondo gris: Bloques de código resaltados
- Estilos profesionales: Tipografía y formato corporativo
Instrucciones
Para convertir un archivo Markdown a DOCX:
- Asegúrate de que pandoc está instalado en el sistema
- Usa el script
scripts/convert.shpara la conversión - Especifica título y autor para generar portada
Uso básico
# Conversión simple (con TOC por defecto)
./scripts/convert.sh archivo.md
# Con título y autor (genera portada)
./scripts/convert.sh archivo.md --title "Mi Documento" --author "Mi Nombre"
# Sin tabla de contenidos
./scripts/convert.sh archivo.md --no-toc
# Con plantilla personalizada
./scripts/convert.sh archivo.md --template mi-plantilla.docx
Opciones del script
| Opción | Descripción |
|---|---|
-o, --output |
Nombre del archivo de salida |
-t, --template |
Plantilla DOCX de referencia para estilos |
--title "TITULO" |
Título del documento (para portada) |
--author "AUTOR" |
Autor del documento |
--date "FECHA" |
Fecha del documento |
--toc |
Incluir tabla de contenidos (por defecto: sí) |
--no-toc |
No incluir tabla de contenidos |
--toc-depth N |
Profundidad del índice (por defecto: 2) |
-h, --help |
Mostrar ayuda |
Metadatos YAML en Markdown
Puedes incluir metadatos al inicio del archivo Markdown:
---
title: "Título del Documento"
author: "Nombre del Autor"
date: "2024-01-15"
---
# Contenido del documento...
Ejemplos
Generar documento con portada e índice
./scripts/convert.sh informe.md --title "Informe Técnico Q4" --author "Equipo Dev" -o informe_final.docx
Documento sin índice
./scripts/convert.sh notas.md --no-toc --title "Notas de Reunión"
Índice con 3 niveles
./scripts/convert.sh manual.md --toc-depth 3 --title "Manual de Usuario"
Personalización de estilos
Para personalizar:
- Cabecera en cada página
- Código con fondo gris
- Limitar bullets a 2 niveles
- Estilos de títulos y fuentes
Consulta la guía detallada: TEMPLATE_GUIDE.md
Resumen rápido
- Abre
templates/reference.docxen Word - Modifica los estilos:
- Source Code: Añadir fondo gris
- Encabezado de página: Añadir título
- Compact3+: Quitar bullets
- Guarda y reemplaza la plantilla
Plantilla de referencia
La plantilla templates/reference.docx define:
- Heading 1-6: Estilos de encabezados
- Body Text: Texto del cuerpo
- Source Code: Bloques de código (fondo gris)
- Table: Estilos de tablas
- Encabezado/Pie: Cabecera y numeración
Dependencias
- pandoc >= 2.0:
brew install pandoc(macOS) oapt install pandoc(Linux)
Verificar instalación de pandoc
pandoc --version
Notas
- Las imágenes referenciadas en el Markdown se incrustan automáticamente
- Los enlaces se preservan como hipervínculos
- Las tablas Markdown se convierten a tablas Word
- El código se formatea con fuente monoespaciada y fondo (si la plantilla lo define)
- La tabla de contenidos se genera automáticamente con 2 niveles por defecto