markup VS github-orgmode-tests

Btw github supports more than just markdown: https://github.com/github/markup#markups

I'm not sure 4. works for colors/styling, style attributes are stripped: https://github.com/github/markup/issues/119

I found this issue, which does not show much traction: https://github.com/github/markup/issues/994

For sharing settings and lore with players, GitHub wiki. Understands Org and several other formats thanks to GitHub Markup, so I can copy in (and trim down) my original notes without much fuss.

Re: https://github.com/github/markup/issues/533

I’m the main author of KeenWrite (see screenshots), a type of desktop Markdown editor that supports diagrams. It’s encouraging to see that Mermaid diagrams are being supported in GitHub. There are a few drawbacks on the syntax and implications of using MermaidJS.

First, only browser-based SVG renderers can correctly parse Mermaid diagrams. I’ve tested Apache Batik, svgSalamander, resvg, rsvg-convert, svglib, CairoSVG, ConTeXt, and QtSVG. See issue 2485. This implies that typesetting Mermaid diagrams is not currently possible. In effect, by including Mermaid diagrams, many documents will be restricted to web-based output, excluding the possibility of producing PDF documents based on GitHub markdown documents (for the foreseeable future).

Second, there are numerous text-to-diagram facilities available beyond Mermaid. The server at https://kroki.io/ supports Mermaid, PlantUML, Graphviz, byte fields, and many more. While including MermaidJS is a great step forward, supporting Kroki diagrams would allow a much greater variety. (Most diagrams produced in MermaidJS can also be crafted in Graphviz, albeit with less terse syntax.)

Third, see the CommonMark discussion thread referring to a syntax for diagrams. It’s unfortunate that a standard “namespace” concept was not proposed.

Fourth, KeenWrite integrates Kroki. To do so, it uses a variation on the syntax:

    ``` diagram-mermaid

I thought it only rendered files in the repo (match by extension). Does GH also allow asciidoc(tor) syntax in comments and issues?

* Note: Sadly, include is not supported on GH. https://github.com/github/markup/issues/1095

- 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/