NormaDocs¶
Convierte Markdown en DOCX/PDF académicos reproducibles y valida el resultado cuando el perfil APA lo requiere. La ruta rápida para trabajos estudiantiles es Quickstart; la ruta para agentes está en AI Agent Guide.
NormaDocs is a professional open-source tool that converts Markdown documents to academically-formatted DOCX and PDF files, with full support for major citation standards.
Features¶
- Multiple Citation Standards: APA 7th Edition (professional + student), ICONTEC (NTC 1486), IEEE 8th Edition
- Automatic Cover Pages: 7-field title block (title, author, program, institution, subject, instructor, date)
- Strict APA Verifier: blank-line rules, continuous pagination, hanging indents, cross-references, 100/100 gate
- Complete Formatting: Margins, typography, and spacing per selected standard
- Bibliography Support: BibTeX (
.bib) files and CSL styles via Pandoc - PDF Generation: LibreOffice or WeasyPrint
- Code Images:
{code}fences rendered as images (optionalcodeimageextra) - LanguageTool Integration: Grammar and spell checking
Quick Start¶
pip install normadocs
# Convertir a APA 7 estudiantil (predeterminado)
normadocs document.md --format docx
# Convertir, generar PDF y validar estrictamente
normadocs document.md --format all --apa-report ExportDocs/apa.md
# Convert to ICONTEC with PDF output
normadocs document.md --style icontec --format pdf
# Custom output directory
normadocs document.md -o ./Submissions -s apa -f all
Supported Standards¶
| Standard | Status | Font | Spacing | Typical Use |
|---|---|---|---|---|
APA 7th student (apa7estudiante, default) |
✅ Formatter + strict verifier | Times New Roman 12pt (or Arial/Calibri/Georgia 11) | Double, continuous | Student papers |
APA 7th professional (apa) |
✅ Formatter + strict verifier + running head | Times New Roman 12pt | Double | Journals, theses |
| ICONTEC (NTC 1486) | ✅ Formatter; manual review | Arial 12pt | 1.5 lines | Colombian Academic |
| IEEE 8th Edition | ✅ Formatter; manual review | Times New Roman 10pt | Single | Engineering/Technical |
Documentation¶
- Installation — Detailed installation instructions
- CLI Usage — Command-line interface reference
- AI Agent Guide — Deterministic contract for AI-assisted use
- Library Usage — Using NormaDocs as a Python library
- Supported Standards — APA 7th, ICONTEC, IEEE formatting details
- Troubleshooting — Common issues and solutions
- Contributing — Development guidelines