> Szóval az egy pozitívum, hogy a Markdown-ba lehet LaTeX-et beágyazni, no de akkor miért ne legyen csak LaTeX?
Bár eléggé csak szőr mentén ismerem, meg ritkán használom, de kifejezetten szeretem a latexet. Ennek ellenére szerintem technikai / termék dokumentációt nem nagyon írnék benne. Az ok egyszerű: elég bonyolult, és nem kifejezetten erre való[1]. Emiatt egyrészt viszonylag sok időt kell jó eséllyel eltölteni, hogy valami alapot faragj, és output oldalon sem igazán rózsás a helyzet. HTML pl ugye. (ne keresd meg, biztosan lehet valahogy)
Ráadásul már egyszerűbb formázásoknál is töri a nyers olvashatóságot, meg az írás flowját. Ez természetesen durván egyén és megszokás függő, én akármi wysiwygben sokkal lassabban írok, nagyon lendít rajtam ha simán csak text gépelek, és ez már latexben is rosszabb. Egy sima lista is \begin{itemize} \item ... \item \end{itemize}, ehhez képest az, hogy enter, * szöveg, ha be kell húzni akkor ** sokkal kényelmesebb.
Abban egyetértünk, hogy a markdown szerintem is nagyon hamar karcsú tud lenni, feljebb is ezért javasoltam az asciidoctort. Nagyon sok mindent tud alapból, amit az ember egy doksinál egyébként használna, kényelmes, sok féle listák, adomontionok, mindenféle blokkok, színezett, számozható megjegyzésekkel kódok pl (ahol az annotáció pl nem jelölődik ki, hogy copypaste friendly legyen), használható táblázatok, amiknek a belsejében is könnyen működnek az extra lehetőségek, inline generált mindenféle diagramok, nyilván van mindenféle list of izéhozé (bár szerintem nagyon ritka kivételtől eltekintve ember nem nézett még list of figurest pl) stb, fogyasztható pdf és html.
Természetesen ezt mind meg lehet csinálni latexban is, sőt, még sokkal többet is, és természetesen a pdf a közelébe nem jön egy jó latex rendernek, de bőven vállalható, cserébe sokkal gyorsabb tanulási görbe, imho sokkal jobb writing élmény, és egy direkt doksikra kihegyezett toolbox van benne alapból.
Ha ennél több kell (pl mert output oldalon még ez is lacking azért) akkor meg a docbook toolchain, bár abban írni azért elég fájdalmas imho. (Alternatívának meg esetleg a restrucutred text).
[1]: tudom tudom, az összes tudós hülye, mert ebben írja, nem értek hozzá, minek szólom le. Szóval értem, ezzel együtt az alapvetően még mindig egy jó automata szedőrendszer, és ha hozzá akarsz nyúlni valamihez, akkor elég sokat kell ilyesmivel cseszni. És in real life egyébként kevésbé érdekes, a "good enough" az üzletileg reális cél.