> A markdown igaz, hogy limitált, de elég a feladatra.
Hát, én szoktam technikai doksikat írni, és elég sokszor nem, nem elég. A common markban még egy istenverte táblázat sincs, nem hogy még szélességet is lehessen befolyásolni, nem lehet érdemben kontrollálni mondjuk a sorszámozást, a corssreferenceket, nincsenek benne változók, csak hogy azokat említsem, amik nagyon hamar előjönnek. A mindenféle text -> diagram generálók inlineolhatóan elérhető beépített garmadája is sokszor hasznos.
Arról nem beszélve, hogy van a markdownnak vagy 5 elterjedt dialektusa.
> Ezt az asciidoctort nem ismerem mondjuk, feltételezem ez is valami plain text alapú leírónyelves megoldás
Nézz rá, egyrészt kicsit hihetőbb lenne a mondanivalód, ha legalább megnézted volna, miről beszélek, másrészt tetszeni fog szerintem, ilyen szempontból markdown on steroids. Csak tudja azt, hogy nem kell konvertálás után kicsit belenyúlkálni, meg nem html snippleteket kell a közepébe írni, ha valami nincs benne, adja a fordító toolchaint, adja az értelmes includeokat, nem neked kell hákolni valamit, ami majd előállítja a doksit, megmutatja, hogy ha akarod, hogyan kell custom cssezni, meg a headereket. Nem azért trúváj, mert sokkal szebbre renderelődik, mint egy markdown htmlbe (nyilván kb ugyanazt tudja), vagy sokkal flexibilisebb mint egy latex (nyilván nem), esetleg szebb pdfet csinál (nyilván nem) hanem az, hogy ez készen van. Általában annyi a teendőd, hogy megkeresed a referenceben, ha valami kicsit extrábbat akarsz, és egyszerűen begépeled, nem kell spanyolviaszt feltalálnod. Természetesen egy kicsit rosszabb a learning curve, de ha rendszeresen írsz, vagy karban kell tartani valami doksit, akkor eléggé kifizetődik.