Documentation au format md, pdf et html

Question

Je travaille sur un projet opensource sur Github. J'avais créé quelques documents dans le format md de Github. Cependant, je veux que ces documents disponibles en trois formats:

1. PDF: à télécharger avec le projet
2. HTML: Pour être hébergé sur mon site personnel.
3. Marquage (.md): Pour Github.

Évidemment je ne préférerais pas les écrire trois fois. Est-il possible que je l'écrive une fois n'importe où (bien que MS Word préféré) et il pourrait être converti en deux autres formats?

Answer 1

Tenir compte Pandoc

j'écrire en Markdown et convertir aux autres.

Answer 2

Une autre possibilité est DITA. Son implémentation de référence gratuite, DITA Open Toolkit, vous permet de générer du code HTML et PDF directement depuis la boîte, et peut également être personnalisée pour générer Markdown. Cependant, DITA peut être une solution plus sophistiquée que nécessaire, en fonction de vos besoins de réutilisation de contenu, de la taille de vos documents, de la fréquence de mise à jour, de l'utilisation d'un rédacteur technique pour gérer et mettre à jour vos documents. ... C'est une solution puissante mieux adaptée à un effort de documentation dédié qu'à une situation ad hoc ponctuelle.