Interactive CommonMark Tutorial | Hacker News Reader

Interactive CommonMark Tutorial

commonmark.org

37 pointsaccrual5 comments

Although not interactive, I've created a video series that shows advanced usage of Markdown. Namely R, external variables, diagrams, math, annotations, and a different approach to metadata:

* https://www.youtube.com/playlist?list=PLB-WIt1cZYLm1MMx2FBG9...

Tutorial 4 shows basic Markdown:

* https://www.youtube.com/watch?v=qNbGSiRzx-0

The top-right of each video shows keyboard and mouse clicks to help follow along.[1] My desktop text editor, KeenWrite[2], is used in the tutorials.

[1]: https://github.com/DaveJarvis/kmcaster

[2]: https://github.com/DaveJarvis/keenwrite

Which Markdown variant would you consider to be the most feature-rich, in terms of graphs, variables, conditionals, transclusion, print, all that jazz?

R Markdown using pandoc and knitr. Initially, I had developed shell scripts to run them alongside YAML metadata[1]. I developed KeenWrite to replace those scripts opting for flexmark-java, which implements the CommonMark standard, and is highly compatible with pandoc.

If your goal is to write a little bit of prose and do lots of data analysis, plots, graphs, etc., then use Jupyter Notebooks. If you plan to write a lot of prose with images, graphs, and plots thrown in, use KeenWrite.

[1]: https://dave.autonoma.ca/blog/2019/05/22/typesetting-markdow...

That's super interesting, thank you for the content and for the reply!

I'm an Asciidoc (+GitLab/VSC/Antora) user and a Markdown, eh, I guess you would say "researcher"[1], but I'm not jingoistic about it. I realize the Markdown tool ecosystem is an order of magnitude larger.

[1] Never having used it in production, R Markdown was one of the "final three" markdown candidates for a project, but we didn't go that way.

I found this to be a really simple and fun way to brush up on my Markdown. It only took a couple of minutes and was enjoyable.

Reply on news.ycombinator.com