News for hackers. Stuff that matters.
Re:Why I Prefer RST to Markdown by thangalin on Wednesday July 31, 2024 @08:10PM (#41124896)
Here are some Markdown books I've crafted:

* https://whitemagicsoftware.com/softcover/technical.pdf

* https://impacts.to/downloads/lowres/impacts.pdf

* https://whitemagicsoftware.com/softcover/jekyll-hyde.pdf

My blog describes shell scripts to use pandoc and knitr for converting Markdown to PDF:

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

I wrote a FOSS GUI/CLI cross-platform desktop application to replace those shell scripts:

* https://keenwrite.com

* https://keenwrite.com/screenshots.html

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

I'm using KeenWrite to write a sci-fi novel and can produce a standard manuscript format in seconds (because the content is kept separate from the presentation).

Regarding technical documentation, I extended Markdown in KeenWrite with a consistent cross-reference syntax for tables, figures, equations, etc.

* https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/docs/ref...

Re:Why I Prefer RST to Markdown by thesnide on Thursday August 01, 2024 @04:01PM (#41132980)
about keenwrite, touting "producing beautifully typeset PDF files" and not giving a single PDF example, ideally its documentation, is a missed opportunity, to say the least ;-)