[ocaml-infra] markdown in "pure" OCaml

[Christophe TROESTLER]

On Wed, 7 Aug 2013 13:58:16 +0100, Philippe Wang wrote:
> 
> Lately I realised that there are actually two markdown render engines
> on github: the one that is officially "GFM" (github flavoured
> markdown), which is used for issues, comments and pull requests, and
> the other one, which is somehow closer to standard markdown, that is
> used to render .md files in repos when you click on them (e.g., any
> .md file in https://github.com/pw374/sandbox/).
> 
> So I've decided that by default, omd should do standard markdown
> newlines, not GFM's.
> 
> >> [gfm_newlines]:
> >> https://help.github.com/articles/github-flavored-markdown#newlines

I think this is a good decision.  Line breaks should not be enforced
for HTML paragraphs as these need to resize well according to the
browser width, font size,...  Moreover, since links will take more
space in Markdown than in HTML, it would be cumbersome to format
paragraphs well if newlines were transformed into <br/>.

While I am at it, I remember that "extension points" were evoked.
They are required IMHO if one wants to attach some code to the
transformation Markdown → HTML.  For example, if one wants to have a
paragraph or a block of code initially hidden (with a button to make
it visible).  Is there any design for this ATM?

Best,
C.