normadocs 0.1.0

Herramienta profesional para convertir Markdown a DOCX/PDF cumpliendo normas (APA, etc.).

NormaDocs

NormaDocs es una herramienta profesional de código abierto diseñada para convertir documentos Markdown a formatos académicos estándar (DOCX, PDF), comenzando con soporte estricto para APA 7ª Edición.

Su arquitectura modular permite la integración futura de otras normas como ICONTEC, IEEE y más.

Características ✨

• Automatización Total: Convierte Markdown simple en documentos listos para entregar.
• Multiformato: Salida en DOCX y PDF.
• Cumplimiento APA 7:
  • Portada automática.
  • Formato Times New Roman 12pt, Doble espacio.
  • Citas y referencias formateadas.
• Modular: Úsalo como CLI (normadocs) o como librería Python (normadocs).

Instalación 📦

Requisitos Previos

• Python 3.12+
• Pandoc
• LibreOffice (Opcional, para PDF)

Desde el repositorio

git clone https://github.com/mackroph/normadocs.git
cd normadocs
make install

Uso 🚀

Línea de Comandos (CLI)

El comando principal es normadocs:

# Ayuda
normadocs --help

# Conversión básica
normadocs IDocs/paper.md

# Conversión a PDF y DOCX en carpeta específica
normadocs IDocs/paper.md -o ./ExportDocs --format pdf

Como Librería (Python)

from pathlib import Path
from normadocs.preprocessor import MarkdownPreprocessor
from normadocs.docx_formatter import APADocxFormatter
from normadocs.pandoc_client import PandocRunner

# 1. Pre-procesar
md_text = Path("paper.md").read_text()
processor = MarkdownPreprocessor()
clean_md, meta = processor.process(md_text)

# 2. Convertir
PandocRunner().run(clean_md, "output.docx")

# 3. Aplicar Normas
formatter = APADocxFormatter("output.docx")
formatter.process(meta)
formatter.save("output_final.docx")

Desarrollo 🛠️

make install  # Instalar dependencias
make test     # Correr tests
make lint     # Verificar calidad
make build    # Crear paquete

Licencia 📄

Este proyecto está bajo la Licencia MIT.