When comparing Org-mode vs AsciiDoc, the Slant community recommends Org-mode for most people. In the question“What are the best markup languages?” Org-mode is ranked 1st while AsciiDoc is ranked 4th. The most important reason people chose Org-mode is:
Org-mode is characterized by a flexible and versatile system with adaptability to different workflows, making it comparable as an Evernote alternative. It is at once simple and complex., which helps it to compete as an Evernote alternative.
Ranked in these QuestionsQuestion Ranking
Pros
Pro Very flexible
Org-mode is characterized by a flexible and versatile system with adaptability to different workflows, making it comparable as an Evernote alternative. It is at once simple and complex., which helps it to compete as an Evernote alternative.
Pro Built-in agenda
Org-mode has some built-in agenda functionality. You can schedule tasks and assign various degrees of importance to each of them. Org-mode agenda can also be synced with Google Calendar.
Pro Versioning can be tracked and synced using Git or other VCS
Org files are plain text, and lend themselves well to version control. Emacs also has good integrations for various VCS.
Pro Great sync support
Notes and to-dos can be synced with Trello, Toodledo, Simplenote, Orgmobile, or with tools like Git on Github, Dropbox, Google Drive, and Bitbucket, while WebDAV (with iOS and Android) can also be exported to PDF, mind map, LaTeX, HTML, Docbook, or txt.
Pro Basic spreadsheet functionality
Org-mode has some basic spreadsheet functionality. Other than auto-formatting ASCII tables (a notoriously annoying problem), it also has support for LISP-like syntax to define equations or any other functionality that can be achieved through spreadsheets.
Pro Out-of-the-box Latex support
Org-mode has out-of-the-box support for Latex: it can immediately parse equations (or other Latex markup) and can even compile notes to PDF or HTML.
Pro Standardized format
The formatting of Asciidoc is standardized so there is only one 'flavor' unlike in Markdown. The definitive user guide is here.
Pro Human-readable
Simple, easy-to-read style similar to Markdown. Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Pro Technical Documentation
The DocBook format which Asciidoctor can convert to was originally developed with the creation of computer books in mind and thus has a rich array of formatting options which are powerful enough to manage the formatting of lengthy technical books.
Pro Supported by GitHub and GitLab
Both GitHub and GitLab support AsciiDoc syntax in repositories, wikis and Gists/Snippets (powered by the Asciidoctor Ruby gem).
Pro It's structured
Cleanly transforms to DocBook and HTML5.
Pro Supports semantic markup
Pro Native support for colored output
AsciiDoc has offered the ability to define both the color of any text output as well as its background, almost since its inception. It accepts several standard chromatic notations for them, too, including hexadecimal and decimal RGB values, decimal HSL and named CSS.
Pro Embedded metadata
The AsciiDoc standard defines a number of metadata values which can be defined inside a document primarily for contextual purposes that aren't rendered in its standard output such as author, date, license, document title and version, etc. These can be especially useful when searching through a large number of files/documents or documenting the evolution of one as part of a larger codebase.
Pro Shorter, more concise than Markdown
Pro Good tool support
There are plugins to support editing AsciiDoc for many editors/IDEs.
Cons
Con Difficult to learn
Org-mode has a difficult learning curve since you have to learn all the keybindings and commands. It's especially difficult if you are not used to Emacs.
Con Not as popular/widely used as Markdown
The Asciidoc format is not as popular/widely used as Markdown. Notwithstanding the foregoing, Asciidoc is used for some of the following projects:
- O'Reilly and Maker Press
- NFJS, the magazine
- other examples
Con Limited output options
Asciidoctor can only convert directly to HTML or DocBook. However, you can always use another converter such as pandoc to convert from one of the output formats to another format.