Continuing the discussion from Peeragogy dev (December 2020):
So, this is the master copy: https://github.com/Peeragogy/Peeragogy.github.io (v3)
This is the experimental Org Mode setup that will replace it: https://github.com/PeeragogyLabs/PeeragogyORG
Yes, Github renders Org, e.g., https://github.com/PeeragogyLabs/PeeragogyORG/blob/main/coworking.org
But the plan is to move to Firn for rendering, e.g., https://peeragogylabs.github.io/PeeragogyORG/coworking
Firn can be set up as a one-for-one replacement of Github Pages/Jekyll, but I’d actually like to go one step further and remove the dependency on Github entirely, moving hosting to a free software solution.
So, in Org it’s possible to define custom blocks: https://alhassy.github.io/org-special-block-extras/
This means for example if we want to use the Tufte margin, we could add
#+BEGIN_SIDENOTE
This is a "mini-Handbook" introducing Org mode:
https://orgmode.org/quickstart.html
#+END_SIDENOTE
and that will then be formatted (subject to writing the correct instructions) correctly in both HTML and PDF downstream formats. It would be possible to hack this sort of thing into Markdown, I’d say, but it’s well supported in Org. More semantics can be added as well.
(I’m glossing over the fact that Firn and Org Mode itself have separate rendering strategies; this will all be sorted out eventually!)