majiayu000 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