Repository navigation
suggestion for another flavor #5
Description
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?
Activity
bentxt commentedon Jan 30, 2023
Some additional references:
aryx commentedon Jan 30, 2023
sounds good to me!
aryx commentedon Jan 30, 2023
If you have a PR I'll be happy to review it and merge it
bentxt commentedon Jan 30, 2023
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.