markdown-clipper VS KeenWrite

I am on a Mac and I use firefox. The extension I use for capturing part or the entire webpage in markdown is https://github.com/deathau/markdown-clipper

My FOSS text editor, KeenWrite[1], takes a similar approach: Markdown -> XHTML -> TeX -> PDF. The software architecture shows how you can have processor chains:

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

I wrote KeenWrite to help writing a sci-fi novel where I can use variables for character names, places, etc. See the tutorials[2] for details.

For anyone still using pandoc and shell scripts, my Typesetting Markdown[3] series describes building a script-based infrastructure for converting Markdown into PDF.

[1]: https://keenwrite.com/

[2]: https://www.youtube.com/watch?v=CFCqe3A5dFg&t=15s

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

The build-template can then be reused to enhance other shell scripts. Note how by defining the command-line arguments as data you can provide a general solution to usage information:

https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/scripts/...

Further, the same command-line arguments list can be used to parse the options:

https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/scripts/...

If you want to get even more clever, it's possible to have the template parse the command-line arguments automatically for any particular script. Tweak the arguments list slightly by prefixing the name of the variable to assign to the option:

    ARGUMENTS+=(

A few of my Markdown documents:

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

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

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

Respectfully, keeping presentation logic and content completely separated while having precise control over layout is possible even with Markdown, as my example documents demonstrate. ConTeXt is an exquisite typesetting system that makes keeping such separation possible.

The deeper issue relates to the software's architecture, which, IMO, systems like Typst, Obsidian, and others fail to implement broadly enough. Here's KeenWrite's architecture (the "Proposed" row):

https://gitlab.com/DaveJarvis/KeenWrite/-/raw/main/docs/imag...

Although only Markdown is currently implemented, it's possible to plug other text-based input formats to produce an XHTML document. The instructions for how to typeset XHTML documents are defined by a theme. You can think of a theme as an XML to TeX translation system. From there, going from XML to TeX is straightforward (using ConTeXt), allowing full control over the final output format.

I am the author of KeenWrite. The following tutorial shows how its themes work:

https://www.youtube.com/watch?v=3QpX70O5S30&list=PLB-WIt1cZY...

I wrote a series of blog posts about typesetting Markdown using pandoc:

https://dave.autonoma.ca/blog

I found pandoc on its own to be a little limiting:

* Awkward to use interpolated variables within prose.

* No real-time preview prior to rendering the final document.

* Limited options for TeX support (e.g., SVG vs. inline; ConTeXt vs. LaTeX).

* Inconsistent syntax for captions and cross-references.

For my purposes, I wanted to convert variable-laden Markdown and R Markdown to text, XHTML, and PDF formats. Eventually I replaced my tool chain of yamlp + pandoc + knitr with an integrated FOSS cross-platform desktop editor.

https://keenwrite.com/

KeenWrite uses flexmark-java + Renjin to provide a solution that can replace pandoc + knitr.

Note how the captions and cross-reference syntax for images, tables, and equations is unified to use a double-colon sigil:

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

My Typesetting Markdown series[1] describes crafting shell scripts to cobble together pandoc, knitr, math, ConTeXt, and YAML-based interpolated variables to produce PDF files.

For my sci-fi novel, my character sheet was inside of a spreadsheet. It dawned on me that the character sheet could be replaced with a YAML file and integrated with a Markdown editor. I developed KeenWrite[2] to replace the scripts while allowing me to use interpolated variables and R inside of the prose.

My novel has two separate timelines and I wanted to make sure that dates lined up correctly without having to do the date math manually. I implemented a number date functions in R[3] based around an "anchor" date. As long as all my other dates are relative (in days) to the anchor date, all the math checks out. Possessives and pronouns are also handled in R (meaning I can change a character's gender by changing a single variable, provided I haven't referenced any sex-specific body parts or characteristics).

Also, I wanted a nice-looking PDF file to send to alpha readers (more wanted, see profile). For that, I crafted KeenWrite Themes[4] along with a video tutorial series showing how all the software components work together.

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

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

[3]: https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/R/conver...

[4]: https://gitlab.com/DaveJarvis/keenwrite-themes/

[5]: https://www.youtube.com/playlist?list=PLB-WIt1cZYLm1MMx2FBG9...

I developed KeenWrite[0] with similar ideas to mdbook: typeset into PDF from Markdown. Technically, this happens in three stages. First, the Markdown is converted to XHTML. Second, the XHTML is converted to TeX commands. Third, the ConTeXt typesetting system produces a PDF file. Both the GUI and CLI can export to PDF.[1]

Like mdbook, the themes are isolated. Instead of CSS, KeenWrite themes are written in ConTeXt. There are several example starter themes.[2] A "thesis" theme would be a nice addition, but there's a problem.

Markdown lacks a standard for cross-references and citations. An open KeenWrite issue animates a possible UX solution.[3] The topic of references/citations has been discussed on CommonMark[4] without much movement. Parsing cross-references and citations would benefit flexmark-java[5] integrations. KeenWrite uses flexmark-java, but I'm otherwise unaffiliated. If anyone is interested in helping, reach out (see profile).

[0]: https://keenwrite.com/

[1]: https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/docs/cmd...

[2]: https://gitlab.com/DaveJarvis/keenwrite-themes/

[3]: https://gitlab.com/DaveJarvis/KeenWrite/-/issues/145

[4]: https://talk.commonmark.org/t/cross-references-and-citations...

[5]: https://github.com/vsch/flexmark-java

My desktop text editor, KeenWrite, uses Wine, rcedit-x64.exe, osslsigncode, and a shell script. First, rcedit-x64.exe tags the binary with identifying information:

https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/installe...

Then osslsigncode applies the certificate:

https://gitlab.com/DaveJarvis/KeenWrite/-/blob/main/scripts/...

Echoing what Rodeoclash wrote: Having to pay to play on Windows for an open-source project that makes $0 is a decline of ownership over our own machines.