Cómo convertí miles de archivos Markdown a DITA XML usando TypeScript
Esta historia ocurrió a mediados de 2023. Finalmente encontré el tiempo libre suficiente para escribir al respecto. Convertir manualmente de Markdown a DITA no es divertido Solía trabajar para una empresa tecnológica que utilizaba DITA XML para su documentación. Por razones que no puedo discutir debido a acuerdos de confidencialidad (NDA), alrededor de cinco productos usaban MkDocs para su documentación en lugar de DITA. Ejecutar ambos sistemas en paralelo parecía estar bien al principio. Sin embargo, eventualmente causó problemas cuando empezamos a integrar esos productos con el resto de nuestro portafolio, que utilizaba DITA para la documentación. Necesitábamos reutilizar contenido y mantenerlo sincronizado, lo que significaba recrear manualmente la mayoría de las cosas. Después de unas semanas de copiar y pegar contenido manualmente, mi gerente decidió que debíamos migrar todo a DITA XML. ...