質問: メリット ----- * 目次生成 * ハイパーリンク * PDFの挿入 * ファイル分割 * itemize や enumerate 環境で箇条書き・連番 * 数式きれい * sublime text からビルド * etc デメリット ------ * コンパイル面倒 * フォントがない場合も面倒 * 分割が多くなると管理が面倒
回答: 個人的にはこんな感じにしています。 1. 簡易手順書 → Markdown (Pandoc) 2. 本格的な手順書 → AsciiDoc (AsciiDoctor) 3. 日本語を考慮した手順書 → Re:VIEW いずれも、TeX形式またはMathMLの数式を埋め込めます。Markdownは方言も多いので、処理系込み考えます。ただ、できることには限界があります。MarkdownとAsciidocはPDF(印刷用)にもHTMLにもできますので、両対応の文書を作るのに便利です。ただ、どちらも英文を書くことが前提で作られた経緯があるため、日本語がすこし苦手です。日本語で出版に耐えられるレベルですと、初めから日本語の文章を考慮しているRe:VIEWがいいかと思います。