What is Reddit's opinion of AsciiDoc?

From 3.5 billion Reddit comments

Markdown is the formatting system that Reddit uses in comments and text posts. AsciiDoc is another formatting system that (apparently) uses a similar format for lists. GaryDuder thinks that Markdown should have done lists like

# Item 1 # Item 2 # ...

instead of

1. Item 1 2. Item 2 3. ...

from another non-latex system. AsciiDoc (or asciiDoctor) is one system. Another is to write in markdown, and then use pandoc to convert to ePub.

See: http://www.methods.co.nz/asciidoc/publishing-ebooks-with-asciidoc.html

I was pleasantly-surprised when I used troff. It may have drawbacks that I have not hit (I've only written a few man pages), but it wasn't terribly complicated (compare to, say, learning LaTeX), it produces good terminal output, and it's not particularly-verbose.

FWIW, you can apparently also author the pages in AsciiDoc and convert to troff. I expect that other formats support conversion as well.

Thanks for the reply.

Yep, you can write macros in AsciiDoc. For LaTeX, the huge amount of add-ons are intriguing, but the syntax seems a bit more complex.

I suppose, like with any language, once you are comfortable it doesn't matter much.

Agreed, Pandoc is an amazing tool for working with markup formats. While Markdown is great for many cases, Asciidoc provides more advanced options for formatting text; it's supported by Pandoc but only as an output format.

Thanks James! I'm looking forward to the discussions on this subreddit.

I'd appreciate any suggestions for improving the formatting of my pamphlet. It currently uses one of the default Asciidoc theme stylesheets. I'm not crazy about it, but it is readable for me. There is a bit of front matter to scroll past, but then it is a short essay with only two top-level headings: start at the top and read to the bottom... I'm not immediately sure how to improve on that...

> I found [1] this link; looks like I might be able to set it up myself, but I (or another mod) will have to look into when I have the time.

Yep, I think that link should get you going once you have time to look into it further. Basically just request addition at [/r/Anarconfederation](/r/Anarconfederation) then add the CSS from the link you found.

http://www.methods.co.nz/asciidoc/ You can write your notes in asciidoc format with nano. Example: http://www.methods.co.nz/asciidoc/article.txt. Also, I recently found this neat article: https://opensource.com/article/17/8/asciidoc-web-development.

I dislike Markdown too. One thing that looks somewhat promising is AsciiDoc. It looks like it supports most of what one would want. I haven't done anything with it, though. I only found it thanks to the Hacker News discussion on this.

http://www.methods.co.nz/asciidoc/asciidoc.txt

Ça me rappelle WordPerfect 4 avec les codes visibles!

J'aimais bien WordPerfect pour Windows par contre; je forçais mes étudiants à utiliser des styles. Je n'avais qu'à ouvrir la fenêtre des codes pour voir s'ils avaient triché!

What you are looking for is called Asciidoc. It has nice markup that is a joy to read even in plaintext (check the cheat sheet) and it compiles to html, pdf, odt, etc.

This is my go to tool for any significant text writing since I hate word processors.

The publisher I work with uses ASCIIDoc (http://www.methods.co.nz/asciidoc/) as a single source for all those formats. Its human readable, and very easy to format. If you are doing a lot of formulas, it allows for passing LaTeX or XML through the interpreter. It also makes a clickable index and table of contents for the PDF, the ePub, and the MOBI file that go straight to the reference rather than the top of the PDF page. And if you move a section, the entries go with it! Pretty fun stuff for an indexer, any way.