Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Markdown's Big Brother: Say Hello to AsciiDoc

git-tower.com

Post reply on HN
Print view View original

11–20 of 65 posts

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#11

Post by sausagefeet »

stragies wrote: post #7

Is there anybody here, who migrated to AsciiDoc from ORG-Mode, and could detail the reasons?

I use both and I use them for different purposes. I use org-mode to stay organized, track todo's, keep notes, etc. I use AsciiDoc to express myself to others, write documentation, and write blog posts. Certainly there is some degree of overlap between the two, but I, personally, don't find org-mode great for writing content to show to others, where-as AsciiDoc is designed for that. Also, there is an AsciiDoc exporter so you can turn org-mode content into AssciiDoc.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#13

Post by kimi »

My company uses Asciidoc for documentation - for almost 20 years now - and it's really good. Now with Antora you can make searchable docs, and with Asciidoctor you can create most diagrams right within the text. We target HTML/PDF/Epub and it works really well.

So you get a result that is Word-quality, but separates presentation and content, and is easy to keep under version control.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#14

Post by andrewl-hn »

We’ve used AsciiDoc for some of our documentation and for generating slide decks.

It is obviously a nice system but over time our frustration with it grew. Every other piece of software we have uses Markdown: GitHub, work chat, chats of open source projects we work with, things like StackOverflow, HackMD, personal note taking apps, the list goes on and on. Every new person joining our team had to adjust to AsciiDoc just for some of the work they would be doing while staying with Markdown for everything else.

We pulled the plug last year and migrated everything we had to Markdown, and while sometimes I need to use HTML tags to do something advanced I don’t mind it as much as I thought I would.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#17

Post by pindab0ter »

xeonmc wrote: post #15
pindab0ter wrote: post #12

Other than inertia, what is keeping AsciiDoc from overtaking Markdown? Personally I like the ubiquity and simplicity of Markdown, but I can also see the benefits of the features AsciiDoc has to offer.

Ruby.

What do you mean? Is Ruby helping or preventing AsciiDoc from becoming more widespread?

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#19

Post by pindab0ter »

andrewl-hn wrote: post #14

We’ve used AsciiDoc for some of our documentation and for generating slide decks. It is obviously a nice system but over time our frustration with it grew. Every other piece of software we have uses Markdown: GitHub, work chat, chats of open source projects we work with, things like StackOverflow, HackMD, personal note taking apps, the list goes on and on. Every new person joining our team had to adjust to AsciiDoc j…

Markdown being so ubiquitous is what makes it valuable, IMO. Do you think AsciiDoc has the potential to reach that point as well?

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#20

Post by ffaser5gxlsll »

andrewl-hn wrote: post #14

We’ve used AsciiDoc for some of our documentation and for generating slide decks. It is obviously a nice system but over time our frustration with it grew. Every other piece of software we have uses Markdown: GitHub, work chat, chats of open source projects we work with, things like StackOverflow, HackMD, personal note taking apps, the list goes on and on. Every new person joining our team had to adjust to AsciiDoc j…

The frustration for me is then which "flavored" version of markdown you're now using, because the evolution seems to always be "MD is simple and popular" until gets extended with subtle differences. Those subtle semi-random differences in flavors get tiring really fast.
Post reply on HN