suggestion for another flavor

[bentxt]

I would like to suggest another more Markdown based flavor when it comes to formatting code blocks und inclusion directives.

Rationale: While everyday coding in the Literate Programming style can be a bit cumbersone, I really like the technique for creating smaller bits of "executable" documentation for the web like blog posts. In this scenario my prefered format is Markdown and the first and formost concern is to publish an article and not to develop software.

Suggestion Code Blocks

Article text

``` { #hellocode .ocaml }
let _ = print_endline "Hello"
```

``` { #hello.ml .ocaml }
<<hellocode>>
```

Hand this is how the html is generated, including nice syntax highlightning

pandoc -s --from=markdown+fenced_code_attributes hello.ml.md > hello.html

I already have changed the regex in lang/web.ml, so I already have a working version.

What do you think of all this?

[bentxt]

Some additional references:

• in pandoc the extension is called "fenced_code_attributes"
• a inplementation in python: https://python-markdown.github.io/extensions/fenced_code_blocks/

[aryx]

sounds good to me!

[aryx]

If you have a PR I'll be happy to review it and merge it

[bentxt]

If you have a PR I'll be happy to review it and merge it

sorry for going of topic, do you by any chance have some experience with this? What would be the workflow/steps you'd suggest here? I avoid version control and especially git like the plague, but I think I'm ready to make another effort.