KeenWrite VS github-orgmode-tests

KeenWrite is my free, open-source, cross-platform desktop Markdown editor that can produce beautifully typeset PDFs. I started working on it years ago to help write a novel that has a complex timeline and I couldn't find a text editor that would allow me to integrate a character sheet with the story itself.

https://github.com/DaveJarvis/keenwrite

Tutorials:

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

Here's what I mean by using variables directly:

* https://www.youtube.com/watch?v=CFCqe3A5dFg

CommonMark doesn't propose a standard for bibliographic references. Would anyone find the editor more appealing if it had cross-references and citations?

My cross-platform desktop text editor, KeenWrite, allows users to define variables in an external YAML file. The editor calls out to Kroki[1] to convert text-based diagrams to SVG. The diagrams can reference variables and are rendered using EchoSVG[2].

KeenWrite[3] can produce PDF documentation from Markdown documents that has PlantUML diagrams with elements stored in an external, machine-readable file. Here are screenshots showing variables on the left, diagram text in the middle, and a real-time render on the right:

* https://raw.githubusercontent.com/DaveJarvis/KeenWrite/main/...

* https://raw.githubusercontent.com/DaveJarvis/KeenWrite/main/...

KeenWrite supports all diagrams offered by Kroki, which includes "diagram-plantuml".

[1]: https://kroki.io/

[2]: https://github.com/css4j/echosvg/

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

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

https://github.com/DaveJarvis/keenwrite/blob/main/scripts/bu...

My template script provides a way to make user-friendly shell scripts. In a script that uses the template, you define the dependencies and their sources:

    DEPENDENCIES=(

I didn't create the fork, nor am I affiliated with the project. I use it in my text editor, KeenWrite to rasterize SVG.

KeenWrite Themes[1] are instructions that tell ConTeXt how to typeset XHTML documents (content) into PDF files (presentation). I made a tutorial that shows how my FOSS desktop text editor, KeenWrite[3], allows users to write in Markdown to typeset a document against a particular theme.

Before it can be used for scientific papers, it needs cross-references, which, unfortunately, aren't part of the CommonMark specification.

I posit that the vast majority of LaTeX users don't grok how to separate content from presentation. When I asked a question on TeX.SE about how to adjust the line spacing between enumerated items (spanning a couple dozen enumerated lists), the vast majority of people voted for the answer of using `\itemsep0em` to tweak each list ... individually.[4] The correct answer, IMO, is to fix the problem globally, and not waste time tweaking individual lists.

[1]: https://github.com/DaveJarvis/keenwrite-themes

[2]: https://www.youtube.com/watch?v=3QpX70O5S30

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

[4]: https://tex.stackexchange.com/questions/6081/reduce-space-be...

- or to visualize and use it as a personal partner.

There's already a ton of open-source UIs such as Chatbot-ui[3] and Reor[4]. And that's just the tip of the iceberg.

Personally, I haven't been consistent enough through the years in note-taking.

So, I'm really curious to learn more about those of you who were and implemented such pipelines.

I'm sure there's a ton of really fascinating experiences.

[1] https://orgmode.org/

literate config (using ORG mode)

Obligatory reference to Emacs Org-Mode [1].

Author's approach is basically Org-Mode with fewer helpers.

Org-mode's power is that, at core, it's just a text file, with gradual augmentation.

Then again, Org-Mode is a tool you must install, accessible through a limited list of clients (Emacs obviously, but also VSCode), and the power of OP's approach is that it requires no external tools.

[1] https://orgmode.org

This reminds me a lot of [Org Mode](https://orgmode.org/). Do you have plans to add other org-like features, like evaluating code blocks? I don't personally see myself moving away from org-mode, but it would be nice to have something to recommend to people who are reluctant to use emacs, even if it's only for a single application.

If you want to spare a couple of detours, you probably could start with Emacs Org-mode according to Greenspun's eleventh rule: "Any sufficiently complicated PIM or note-taking program contains an ad hoc, informally specified, bug-ridden, slow implementation of half of Org mode."

Wow, no one has recommended Org mode (https://orgmode.org). I started using Emacs nearly 20 years ago specifically because of Org. I use Org for all my static sites, note taking, to-do lists and calendar. Org has a lightweight markup language that has far more features than Markdown (e.g., plain text spreadsheets!), but the markup isn't visible to the extent that Markdown is in most editors. Emacs with Org files behaves almost like a WYSIWYG editor. For example, links in Org files are clickable and their URLs aren't visible unless a cursor is hovered over them. I'm an obsessive note-taker with more than 6,000 Org files in my personal knowledge base and none of the dozens of other note-taking apps that I've evaluated comes even close to Emacs with Org. But to be fair, I create content on Linux only so support for mobile devices doesn't matter to me.

By the way, I think it's hilarious that you mentioned Dreamweaver, dv35z, because I experimented with using Dreamweaver for note-taking in the 90s! I still have a few HTML files that include notes I took back then using Dreamweaver. Needless to say, I definitely prefer Emacs with Org!

Just another reason for one to get into org-mode[1] and org-roam[2].

Combine this with the concept of Zettelkasten[3] and you have a wonderful way to organize and store all your notes and writings, and even a way to know at what point you should move your idea from analog to digital (based on it's maturity, e.g. "evergreen state").

1. https://orgmode.org/