#djot — Public Fediverse posts

Twenty years of pandoc. Awesome. Where would we be without it (and curl)?

https://pandoc.org/twenty-years-of-pandoc.html

#markdown #pdf #djot #orgmode

Twenty years of pandoc. Awesome. Where would we be without it (and curl)?

https://pandoc.org/twenty-years-of-pandoc.html

#markdown #pdf #djot #orgmode

TIL about Djot and it's fascinating! It's like someone fixed the markdown bugs :D

https://djot.net

#markdown #templates #djot

TIL about Djot and it's fascinating! It's like someone fixed the markdown bugs :D

https://djot.net

#markdown #templates #djot

I went ahead with this and
- switched my blog to djot
- plan to maintain cdjot and gemtext.lua
- marked my smu fork as unmaintained and added a short retro to the readme
- marked my md2gemini fork as unmaintained
- wrote a blog post about it

See https://www.karl.berlin/djot.html

#djot #markdown #geminiprotocol #blog

The re·sil·ient collection of modules for the #SILE #digitalTypesetting system is my solution for streamlining the production of #PDF books “from the front to the back cover” using lightweight markup languages such as #djot

More than a year ago, I fancied the idea of using gradients instead of solid colors in the design of some elements....

The re·sil·ient collection of modules for the #SILE #digitalTypesetting system is my solution for streamlining the production of #PDF books “from the front to the back cover” using lightweight markup languages such as #djot

More than a year ago, I fancied the idea of using gradients instead of solid colors in the design of some elements....

#Markdown has horrible edge cases and despite the valiant effort of #CommonMark, the dialects seem to diverge and multiply over time. I consider switching my personal stuff to #djot where possible: https://djot.net/

Ideas:
- Stop working on #smu https://github.com/karlb/smu and maintain either https://github.com/karlb/cdjot or https://github.com/karlb/minipandoc instead
- Use https://github.com/karlb/gemtext.lua to generate #gemtext (for #geminiprotocol instead of the unmaintained https://github.com/karlb/md2gemini

Thoughts?

The new #Djot for #PHP docs are online: https://php-collective.github.io/djot-php/ - including detailed syntax reference and playground. And if you are at it, check out the new "awesome djot" list: https://github.com/dereuromark/awesome-djot

The new #Djot for #PHP docs are online: https://php-collective.github.io/djot-php/ - including detailed syntax reference and playground. And if you are at it, check out the new "awesome djot" list: https://github.com/dereuromark/awesome-djot

Just released v4.0 of my _re·sil·ient_ collection of modules for the #SILE digital typesetting system.
Authoring PDF books from front cover to back cover, in lightweight markup language, and more.
#digitalTypesetting #djot #markdown

Just released v4.0 of my _re·sil·ient_ collection of modules for the #SILE digital typesetting system.
Authoring PDF books from front cover to back cover, in lightweight markup language, and more.
#digitalTypesetting #djot #markdown

🎉 #Djot (#PHP) is now officially available worldwide as #plugin in Wordpress installs: https://wordpress.org/plugins/djot-markup/
Please feel free to test it, review and rate it so people have confidence in switching over from markdown or other systems. Safer than MD.
Use in Gutenberg blocks and more.

Most notably, it now contains also useful addons like
- TOC
- Permalinks (clickable/copyable)
- Enhanced syntax (e.g. Markdown compatibility mode)
- Permissions per spec element (author vs commenter etc)

🎉 #Djot (#PHP) is now officially available worldwide as #plugin in Wordpress installs: https://wordpress.org/plugins/djot-markup/
Please feel free to test it, review and rate it so people have confidence in switching over from markdown or other systems. Safer than MD.
Use in Gutenberg blocks and more.

Most notably, it now contains also useful addons like
- TOC
- Permalinks (clickable/copyable)
- Enhanced syntax (e.g. Markdown compatibility mode)
- Permissions per spec element (author vs commenter etc)

Like you, I use markdown to write notes in Joplin. And to write Fedi posts such as this one. (wafrn, the Fedi software I am using, supports writing posts in markdown.)

My only suggestion: do not get seduced by markdown's ease of use. Do not try to use it indiscriminately. Do not use it for documents that require complex markup (text with lots of subscripts/superscripts, mathematical equations, chemical formulae, nested sections, tables, columns, etc.), or even for simple but very long documents (long-form writing, books).

Basically, limit its use to short documents/notes that require very little markup.

This article is a good overview of the benefits and limitations of markdown.

As an aside, I hope djot replaces markdown as the most popular lightweight markup language in the near future.

Like you, I use markdown to write notes in Joplin. And to write Fedi posts such as this one. (wafrn, the Fedi software I am using, supports writing posts in markdown.)

My only suggestion: do not get seduced by markdown's ease of use. Do not try to use it indiscriminately. Do not use it for documents that require complex markup (text with lots of subscripts/superscripts, mathematical equations, chemical formulae, nested sections, tables, columns, etc.), or even for simple but very long documents (long-form writing, books).

Basically, limit its use to short documents/notes that require very little markup.

This article is a good overview of the benefits and limitations of markdown.

As an aside, I hope djot replaces markdown as the most popular lightweight markup language in the near future.

#Djot markup for #PHPStorm IDE etc: https://github.com/php-collective/djot-intellij Auto detects the .djot files and renderes the preview. Can use the #PHP lib to render exactly what would render out online.

#Djot markup for #PHPStorm IDE etc: https://github.com/php-collective/djot-intellij Auto detects the .djot files and renderes the preview. Can use the #PHP lib to render exactly what would render out online.

Thanks to @dereuromark, phpDocumentor Guides now has support for #djot 🎉

Djot is an improved and more precisely specified alternative to Markdown, designed to remove ambiguities and edge. It offers clearer rules, better nesting, and more consistent parsing, which makes it especially well-suited for technical documentation.

Learn more about djot: https://djot.net

https://github.com/phpDocumentor/guides-djot

#php #documentation #phpdoc

#Djot for #PHP

Finally ready to be used.

Check out my post about it: https://www.dereuromark.de/2025/12/09/djot-php-a-modern-markup-parser/

You can also play around in the sandbox and get a feel of it.

Is it the markdown successor we have been waiting for?

#Djot for #PHP

Finally ready to be used.

Check out my post about it: https://www.dereuromark.de/2025/12/09/djot-php-a-modern-markup-parser/

You can also play around in the sandbox and get a feel of it.

Is it the markdown successor we have been waiting for?

Oh wow, a website served from #Neovim #buffers on a relic ThinkPad! 🚀 Because who needs cutting-edge server tech when you can cobble together a shameless hipster project with #Lua and #Djot faster than Nginx, right? 😂 Apparently, turning text editors into web servers is the new cool—move over, actual web developers. 🔧💻
https://vim.gabornyeki.com/ #ThinkPad #HipsterProject #HackerNews #ngated

Oh wow, a website served from #Neovim #buffers on a relic ThinkPad! 🚀 Because who needs cutting-edge server tech when you can cobble together a shameless hipster project with #Lua and #Djot faster than Nginx, right? 😂 Apparently, turning text editors into web servers is the new cool—move over, actual web developers. 🔧💻
https://vim.gabornyeki.com/ #ThinkPad #HipsterProject #HackerNews #ngated

#Markdown Is a Disaster: Why and What to Do Instead
https://karl-voit.at/2025/08/17/Markdown-disaster/

Here's my article where I summarize the subtle and no so subtle downsides when you choose Markdown for your information instead of a different markup syntax that doesn't come with all the downsides of #MD.

#publicvoit #orgdown #orgmode #LML #pandoc #rst #restructuredtext #asciidoc #Wikitext #BBCode #Creole #Crossmark #Djot #CommonMark #lockin

#Markdown Is a Disaster: Why and What to Do Instead
https://karl-voit.at/2025/08/17/Markdown-disaster/

Here's my article where I summarize the subtle and no so subtle downsides when you choose Markdown for your information instead of a different markup syntax that doesn't come with all the downsides of #MD.

#publicvoit #orgdown #orgmode #LML #pandoc #rst #restructuredtext #asciidoc #Wikitext #BBCode #Creole #Crossmark #Djot #CommonMark #lockin

me: hey, with trixie around the corner, i might finally have a version of pandoc in debian that supports djot

#Debian #Trixie #DebianTrixie #Pandoc #djot

me: hey, with trixie around the corner, i might finally have a version of pandoc in debian that supports djot

#Debian #Trixie #DebianTrixie #Pandoc #djot

@pandoc Interesting tip. It's worth nothing that "pandoc.read" takes a second optional argument, the format (default markdown), so using "djot" here for instance woudld allow metadata in #djot etc.
Subsequent question; can this be derived from the input file (or specified input format with -f) ?

@pandoc Interesting tip. It's worth nothing that "pandoc.read" takes a second optional argument, the format (default markdown), so using "djot" here for instance woudld allow metadata in #djot etc.
Subsequent question; can this be derived from the input file (or specified input format with -f) ?

#TeXLaTeX or SILE in #markdown :
- Inline $\varinjlim_{n \in N}$
- Display $$\varinjlim_{n \in N}$$

#SILE in SIL language :
- Inline \math{\varinjlim_{n \in N}}
- Display \math[mode=display]{\varinjlim_{n \in N}}

#SILE in #Djot :
- Inline $`\varinjlim_{n \in N}`
- Display $$`\varinjlim_{n \in N}`

#Typst
- Not that straightforward? https://forum.typst.app/t/how-to-create-the-colimit-symbol-varinjlim/2366

#MathML without dirty hacks nor CSS
- Gimme a hint!

They (soft-)deleted the Djot article on the English #Wikipedia instead of completing it? Come on. #Djot is one of the few thought-through markup languages. Put some effort into this, community!

https://en.wikipedia.org/wiki/Wikipedia:Articles_for_deletion/Djot

Today's thoughts?
Sometimes I smile seeing posts such as: "Do you use #TeXLaTex, #context, #typst, or #patoline as #digitalTypesetting solution?").

What about just #markdown or #djot to #pdf with _one_ software? It's called the #sile typesetter with just _one_ extra collection installed:
https://github.com/Omikhleia/resilient.sile

(Heh! Don't tell me it counts as 2 if you need Pandoc, LaTeX, _lots_ of CTAN modules to achieve the same, not even that. Book covers,, ISBN, styling... all in just _one_ collection.

"Le Dragon de Brume" is glad to announce the Summer 2024 edition of its PDF booklet "A bibliography of Tolkien studies in French & English".

https://sites.google.com/site/dragonbrumeux/bibliography

As for our previous volumes, all source files are available in #djot and (a subset of) #biblatex – using the (currently in-development) bibliography and citation modules for the #sile typesetting system.

#Tolkien #TolkienStudies #tolkiendil

"Le Dragon de Brume" is glad to announce the Summer 2024 edition of its PDF booklet "A bibliography of Tolkien studies in French & English".

https://sites.google.com/site/dragonbrumeux/bibliography

As for our previous volumes, all source files are available in #djot and (a subset of) #biblatex – using the (currently in-development) bibliography and citation modules for the #sile typesetting system.

#Tolkien #TolkienStudies #tolkiendil

"Le Dragon de Brume" is glad to announce "On cartography, maps & locations in Middle-earth" -- a collection of essays on JRR Tolkien's world, translated from French into English.

Beside a regular print edition, in an "open access" spirit, the PDF is also made available.

https://sites.google.com/site/dragonbrumeux/on-cartography-maps-locations-in-middle-earth

All source files are provided too in #djot format mostly; for the curious-minded, the book was composed with the #sile typesetter.

#sile #digitalTypesetting #TolkienStudies #tolkien #tolkiendil

"Le Dragon de Brume" is glad to announce "On cartography, maps & locations in Middle-earth" -- a collection of essays on JRR Tolkien's world, translated from French into English.

Beside a regular print edition, in an "open access" spirit, the PDF is also made available.

https://sites.google.com/site/dragonbrumeux/on-cartography-maps-locations-in-middle-earth

All source files are provided too in #djot format mostly; for the curious-minded, the book was composed with the #sile typesetter.

#sile #digitalTypesetting #TolkienStudies #tolkien #tolkiendil

I wonder whether #djot considers that "smart quotes" are a locale-dependent concept.

Depending on the language & writing system, you need to insert different symbols «„” for ". Since djot seems to only target the web, they could resort to <q> tags, but they don't seem to.

Anyhow, in the end, they don't require any locale declarations but replace ".

https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/master/doc/syntax.html#smart-punctuation

#djot tree-sitter grammar, already now available in nvim-tree-sitter!

https://github.com/treeman/tree-sitter-djot

Let's create a Tree-sitter grammar
https://www.jonashietala.se/blog/2024/03/19/lets_create_a_tree-sitter_grammar/
#ycombinator #Djot #Neovim #Rust #Tree_sitter

Let's create a Tree-sitter grammar
https://www.jonashietala.se/blog/2024/03/19/lets_create_a_tree-sitter_grammar/
#ycombinator #Djot #Neovim #Rust #Tree_sitter

Its week 5 :) #weekly #blogpost #5 #ios17.4 #throughthelens #opensource #markdown #emacs #request #expensetracker #app #djot #lightmarkup

arkoinad.com/posts/weekly_post_5.html

@benmschmidt @alerque You can see an example here https://mastodon.social/@omikhleia/111518778130369008

(I didn't tell it there, but the input document shown on the right side of the image is in #djot). I authored a book (mostly) in Djot, and I am working on another similar one.

@benmschmidt Took a quick look and bounced at the enforced blank lines for style elements.

#Markdown isn't great, but it works well enough with my own practices. #djot enforces a change that I can guarantee I will get annoyingly wrong.

Somehow I'm only just finding about #djot (https://djot.net/), pandoc creator John MacFarlane's alternative to #markdown. I've been rendering most of my writing directly on the #pandoc AST lately, and djot seems to have a very clean AST-first design that could replace it. Anyone using it at all?

Tempted to invest some time and effort into the Djot (https://github.com/jgm/djot) ecosystem. Port my personal website, etc.

Any experiences / opinions to share? #djot #markdown

"Le Dragon de Brume" is glad to announce the publication of "On some stars, flowers & places in Middle-earth" -- a small collection of essays on JRR Tolkien's Middle-earth.

Beside a regular print edition, the PDF is also made available and the sources are even provided.

https://sites.google.com/site/dragonbrumeux/on-some-stars-flowers-places-in-middle-earth

#tolkiendil #tolkien #TolkienStudies #essays #SILE #digitalTypesetting #djot

#WeeklyReview

#listeningto
- chill electronic like the album "Labyrinth" by LE YORA et al, "What we see" by Grandbrothers and "Fusion Royal" by Satin Jackets et al.

#Reading
- https://www.cortexfutura.com/nasa-adlr-lessons-learned-tana/
- https://medium.com/obsidian-observer/how-to-use-cornell-notes-in-the-21st-century-805c53890857
- https://thesephist.com/posts/backprop-through-reasoning/
- https://davetroy.medium.com/no-elon-and-jack-are-not-competitors-theyre-collaborating-3e88cde5267d

#TIL
- #djot markup lang
- @aral "small web" project
- Eisenhower decision matrix
- #JuliaLang TimerOutput package
- The MyST markdown language and their literary programming ecosystem
- NASA's ADLR framework

Sooooo in that case, there's really only one thing missing from #djot to make it a drop-in replacement for our bastardization of CommonMark: GFM Autolinks.

https://github.github.com/gfm/#autolinks-extension-

That and spoilers. 😋

For context, I was foiled by #djot. 😅

I forgot that #CommonMark had an HTML title attribute syntax. i.e. [link name](https://link.url "link title"). Djot has this too, but it's generalized in their {attribute=value} syntax. I was tempted to add the classic syntax to djot, but in hindsight it's not very useful.

So, bold new idea: What if "link title" syntax was used for alt text? Accessibility is important, right?

Well, I forgot that images already have it: . 🤦‍♂️

(Also, holy shit, I just discovered #pandoc, a universal document converter from the creator of #Djot! I need to run some tests, but this might be something I can use to convert the old #LDJam HTML blog post data into Commonmark! OMG, I was dreading having to write my own tool. 😆)