Skip to content

suggestion for another flavor #5

@bentxt

Description

@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?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions