Show HN: Ditto – Markdown documentation system
1–10 of 27 posts
Re: Show HN: Ditto – Markdown documentation system
#2This is great! I'm building our docs using Aglio right now and it's great - this seems similar but with some interesting differences. Really good to see more options out there!
Re: Show HN: Ditto – Markdown documentation system
#3I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
Re: Show HN: Ditto – Markdown documentation system
#4Almost looks like Slate Docs[1].
Re: Show HN: Ditto – Markdown documentation system
#5I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
I've never heard of AsciiDoc, but I'd say the biggest advantage that Markdown has is its ubiquity. It's used by GitHub, StackOverflow, Reddit, and even Tumblr has an option for it.
Re: Show HN: Ditto – Markdown documentation system
#6I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
It was simply the plain-text format I am currently using, I'm sure I can add in compatibility for AsciiDoc no probs. Just a matter of adding in an AsciiDoc renderer. :)
Re: Show HN: Ditto – Markdown documentation system
#7I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
I've never heard of AsciiDoc, but I'd say the biggest advantage that Markdown has is its ubiquity. It's used by GitHub, StackOverflow, Reddit, and even Tumblr has an option for it.
Also the fact that there are multiple (and good) client-side Markdown libraries while stuff like AsciiDoc generally requires server-side rendering (and the associated server load and round-trip penalties).
Unless I'm missing it, there's no pure client-side AsciiDoc?
Re: Show HN: Ditto – Markdown documentation system
#8I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
It looks powerful, but with a much steeper learning curve for non technical users[1]. I could see the nested list support being great for outlines, and tables look a lot more robust than in markdown, but I do not know if it is worth the tradeoffs of going against markdown's ubiquity.
Re: Show HN: Ditto – Markdown documentation system
#9Earlier quoted context omitted.
I've never heard of AsciiDoc, but I'd say the biggest advantage that Markdown has is its ubiquity. It's used by GitHub, StackOverflow, Reddit, and even Tumblr has an option for it.
Also the fact that there are multiple (and good) client-side Markdown libraries while stuff like AsciiDoc generally requires server-side rendering (and the associated server load and round-trip penalties). Unless I'm missing it, there's no pure client-side AsciiDoc?
[1] seems to be an AsciiDoc render on client-side, though have no idea if it's any good though...
[1]: http://asciidoctor.org/news/2013/05/21/asciidoctor-js-render...
Re: Show HN: Ditto – Markdown documentation system
#10I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
I've never heard of AsciiDoc, but I'd say the biggest advantage that Markdown has is its ubiquity. It's used by GitHub, StackOverflow, Reddit, and even Tumblr has an option for it.
I think ubiquity comes with knowledge, if there exists superior tools, people tend to use them eventually. I know that GitHub supports AsciiDoc already, one would hope that the other ones become enlightened!