[Haskell-cafe] Markdown extension for Haddock as a GSoC project

[Ben]

asciidoc has been mentioned a few times in comments, i think it's worth looking at.  

* mature, over 10 years old (predates markdown i think), not "just another markdown clone"
* human readable, but it has a lot of advanced features including mathematical formulas.  
* github supports it (they were sufficiently impressed with it to make a ruby implementation called asciidoctor)
* several o'reilly books have been written in it, and the git documentation is written in it.

roughly, asciidoc is to docbook as markdown is to html.  i'm no expert in this area but it seems to be a good alternative.

http://asciidoc.org/
http://asciidoctor.org/docs/what-is-asciidoc-why-use-it/

best, ben

On Apr 27, 2013, at 11:06 AM, Bryan O'Sullivan wrote:

> On Sat, Apr 27, 2013 at 2:23 AM, Alistair Bayley <alistair at abayley.org> wrote:
> How's about Creole?
> http://wikicreole.org/
> 
> Found it via this:
> http://www.wilfred.me.uk/blog/2012/07/30/why-markdown-is-not-my-favourite-language/
> 
> If you go with Markdown, I vote for one of the Pandoc implementations, probably Pandoc (strict):
> http://johnmacfarlane.net/babelmark2/
> 
> (at least then we're not creating yet another standard...)
> 
> Probably the best way to deal with this is by sidestepping it: make the support for alternative syntaxes as modular as possible, and choose two to start out with in order to get a reasonable shot at constructing a suitable API.
> 
> I think it would be a shame to bikeshed on which specific syntaxes to support, when a lot of productive energy could more usefully go into actually getting the work done. Better to say "prefer a different markup language? code to this API, then submit a patch!"
> _______________________________________________
> Haskell-Cafe mailing list
> Haskell-Cafe at haskell.org
> http://www.haskell.org/mailman/listinfo/haskell-cafe