脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレ - Qiita

asciidocとは asciidocはMarkdownなどのような軽量マークアップ言語の一つで、Webページなどをプレーンテキストで記述することができる(拡張子は.adoc) asciidocを使うようになった経緯 これまではWordで機能仕様書とか書いていたが、Wordは重い、変更場所が分からない、複数人同時に修正とか面倒で、いい加減Wordを使うのは止めたくなった なので軽量マークアップ言語にしよう、一番メジャー？なMarkdownにしたら、以下の制約とかでいくらなんでもイマイチ。。 表でセルの結合ができない 表のセル内で箇条書きができない 目次が作れない 文字に色がつけられない 上記に対応しようとすると、プラグインやらMarkdown亜種がいろいろ。。 そこで、Markdownより表現方法が豊富なasciidocを使用し、実際に使って、特徴・課題を挙げてみた。 asciidocto

[otituke]

確かにMarkdownだけだと無理なんだけど、TeXとasciidocは触れてはいけない世界線のような気がしてる

[tmatsuu]

色をつける機能も標準であるのか。実はMarkdownでもreSTでもなく、asciidocが真のフロンティアだったのでは。

[medicineman]

複雑な表を作ろとすると記法が軽量じゃなくなる件について

[zu2]

この分野、標準が確立されて欲しいのだが…… 昔はnroffとか使ってた

[jsstudy]

Markdownにしたら、以下の制約とかでいくらなんでもイマイチ。。 表でセルの結合ができない 表のセル内で箇条書きができない 目次が作れない 文字に色がつけられない

[kamenashi1982]

便利そうだけど〜 高機能すぎて事故るんじゃないかなあ

[l08084]

アスキードックとかいうのがあるのか（そこから…)勝手にmarkdown一強なのかと思ってた

[kanon1023]

　環境構築方法

[richard_raw]

ちょっと凝ったことしようとしたらMarkdownで無理だったりしますからねえ。/ブラウザ側にプラグインが必要なのか……。/どことなくLaTeX感ある。

[externalight]

イイ感じなのを見つけたいよなー。

[sky-y]

PandocでWord(docx)→asciidoc変換、できるのは知ってたけど事例は初めて見た。（ちなみに逆は現時点でできない。Pandocの知る人ぞ知る弱点。）

[jumperson]

Markdownから乗り換えようと思ったけど複雑なので一旦断念。