sueden.social

Karl Voit :emacs: :orgmode:<a href="https://graz.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> Is a Disaster: Why and What to Do Instead <a href="https://karl-voit.at/2025/08/17/Markdown-disaster/" rel="nofollow noopener" translate="no" target="_blank">https://karl-voit.at/2025/08/17/Markdown-disaster/</a>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 <a href="https://graz.social/tags/MD" class="mention hashtag" rel="nofollow noopener" target="_blank">#MD</a>.<a href="https://graz.social/tags/publicvoit" class="mention hashtag" rel="nofollow noopener" target="_blank">#publicvoit</a> <a href="https://graz.social/tags/orgdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgdown</a> <a href="https://graz.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> <a href="https://graz.social/tags/LML" class="mention hashtag" rel="nofollow noopener" target="_blank">#LML</a> <a href="https://graz.social/tags/pandoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#pandoc</a> <a href="https://graz.social/tags/rst" class="mention hashtag" rel="nofollow noopener" target="_blank">#rst</a> <a href="https://graz.social/tags/restructuredtext" class="mention hashtag" rel="nofollow noopener" target="_blank">#restructuredtext</a> <a href="https://graz.social/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> <a href="https://graz.social/tags/Wikitext" class="mention hashtag" rel="nofollow noopener" target="_blank">#Wikitext</a> <a href="https://graz.social/tags/BBCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#BBCode</a> <a href="https://graz.social/tags/Creole" class="mention hashtag" rel="nofollow noopener" target="_blank">#Creole</a> <a href="https://graz.social/tags/Crossmark" class="mention hashtag" rel="nofollow noopener" target="_blank">#Crossmark</a> <a href="https://graz.social/tags/Djot" class="mention hashtag" rel="nofollow noopener" target="_blank">#Djot</a> <a href="https://graz.social/tags/CommonMark" class="mention hashtag" rel="nofollow noopener" target="_blank">#CommonMark</a> <a href="https://graz.social/tags/lockin" class="mention hashtag" rel="nofollow noopener" target="_blank">#lockin</a>

Nicolas Delsaux<a href="https://mastodon.social/@DJGummikuh" class="u-url mention" rel="nofollow noopener" target="_blank">@DJGummikuh</a> <a href="https://mastodon.social/@dashorst" class="u-url mention" rel="nofollow noopener" target="_blank">@dashorst</a> <a href="https://mastodon.online/@cstamas" class="u-url mention" rel="nofollow noopener" target="_blank">@cstamas</a> <a href="https://mastodon.social/@khmarbaise" class="u-url mention" rel="nofollow noopener" target="_blank">@khmarbaise</a> I don't use that thing, I always do <a href="https://framapiaf.org/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> (which has a descriptive, non tongue-in-cheek, clear name)

James CrowleyWanted to re-acquaint myself with <a href="https://mastodon.social/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> workflow so I manually reformatted a 20-year-old <a href="https://mastodon.social/tags/TTRPG" class="mention hashtag" rel="nofollow noopener" target="_blank">#TTRPG</a> PDF I know well. Tables, callouts, footnotes, document metadata, all the stuff that can be bolted-on to <a href="https://mastodon.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> but is built into AsciiDoc.It took a fair bit of my day off yesterday, and was arguably yak-shaving, but worth it in the end to have The Ultimate Version of the document I've used for decades.

Frank Hofmannjedes Mal, wenn ich den <a href="https://mastodon.social/tags/Asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#Asciidoc</a>-Quellcode des <a href="https://mastodon.social/tags/Debian" class="mention hashtag" rel="nofollow noopener" target="_blank">#Debian</a>-<a href="https://mastodon.social/tags/Paketmanagement" class="mention hashtag" rel="nofollow noopener" target="_blank">#Paketmanagement</a>-Buches nach PDF mit einem schlichten "make pdf" übersetze, freue ich mich, wie reibungslos das seit so langer Zeit funktioniert. Was <a href="https://chaos.social/@xtaran" class="u-url mention" rel="nofollow noopener" target="_blank">@xtaran</a> da doch so gutes zusammengeskriptet hat 🌻 Und alles ohne KI 🙂 <a href="https://mastodon.social/tags/dpmb" class="mention hashtag" rel="nofollow noopener" target="_blank">#dpmb</a> <a href="https://mastodon.social/tags/Linux" class="mention hashtag" rel="nofollow noopener" target="_blank">#Linux</a> <a href="https://mastodon.social/tags/Paketmanagement" class="mention hashtag" rel="nofollow noopener" target="_blank">#Paketmanagement</a> <a href="https://dpmb.org/" rel="nofollow noopener" translate="no" target="_blank">https://dpmb.org/</a>

Oleksii<a href="https://polymaths.social/@dendrobatus_azureus" class="u-url mention" rel="nofollow noopener" target="_blank">@dendrobatus_azureus</a> I found <a href="https://social.linux.pizza/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> language more promising, but less common compare to regular markdown. I'm wondering what other think about both of them.

XLBilly<a href="https://functional.cafe/@xgqt" class="u-url mention" rel="nofollow noopener" target="_blank">@xgqt</a> As far as I know, Github, Gitlab and Gitea has support for <a href="https://social.vivaldi.net/tags/OrgMode" class="mention hashtag" rel="nofollow noopener" target="_blank">#OrgMode</a> and <a href="https://social.vivaldi.net/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> files.

Karakun🛠️ Diagramm oder Doku? Warum nicht beides!Unser CEO <a href="https://jit.social/@madmas" class="u-url mention" rel="nofollow noopener" target="_blank">@madmas</a> zeigt am 12. Mai auf der betterCode() ArchDoc, wie Architekturdiagramme und Dokumentation gemeinsam entstehen – mit PlantUML, AsciiDoc & Antora, automatisiert via GitLab CI. Ideal für alle, die Architektur dokumentieren, ohne doppelte Arbeit zu machen. Oder Chaos. 😉 🔗 <a href="https://archdoc.bettercode.eu/veranstaltung-83492-se-0-diagramm-oder-doku-warum-nicht-beides.html" rel="nofollow noopener" translate="no" target="_blank">https://archdoc.bettercode.eu/veranstaltung-83492-se-0-diagramm-oder-doku-warum-nicht-beides.html</a><a href="https://karakun.social/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#DocsAsCode</a> <a href="https://karakun.social/tags/SoftwareArchitecture" class="mention hashtag" rel="nofollow noopener" target="_blank">#SoftwareArchitecture</a> <a href="https://karakun.social/tags/PlantUML" class="mention hashtag" rel="nofollow noopener" target="_blank">#PlantUML</a> <a href="https://karakun.social/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> <a href="https://karakun.social/tags/Antora" class="mention hashtag" rel="nofollow noopener" target="_blank">#Antora</a>

Karl Voit :emacs: :orgmode:Should I dare to do a "why <a href="https://graz.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> is one of the worst lightweight markup syntax languages there is"-session at a UX/UI-dominant <a href="https://graz.social/tags/barcamp" class="mention hashtag" rel="nofollow noopener" target="_blank">#barcamp</a>? 😜 C'mon, do push me over that cliff! 😆 Background: <a href="https://karl-voit.at/2017/09/23/orgmode-as-markup-only/" rel="nofollow noopener" translate="no" target="_blank">https://karl-voit.at/2017/09/23/orgmode-as-markup-only/</a> 👉 it's related but would be a different focus since I won't push <a href="https://graz.social/tags/orgdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgdown</a> that much - people can be happier with other LMLs as well as long as it's not the <a href="https://graz.social/tags/MD" class="mention hashtag" rel="nofollow noopener" target="_blank">#MD</a> hell. (Sneak preview: I'm writing a long article on all the MD issues in order to explain it once and for all since the Mastodon discussions are really annoying to me.) <a href="https://graz.social/tags/LML" class="mention hashtag" rel="nofollow noopener" target="_blank">#LML</a> <a href="https://graz.social/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> <a href="https://graz.social/tags/rSt" class="mention hashtag" rel="nofollow noopener" target="_blank">#rSt</a> <a href="https://graz.social/tags/WikiText" class="mention hashtag" rel="nofollow noopener" target="_blank">#WikiText</a> <a href="https://graz.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a>

0xKaishakunin<a href="https://chaos.social/@slothrop" class="u-url mention" rel="nofollow noopener" target="_blank">@slothrop</a> <a href="https://mastodon.social/tags/markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#markdown</a> has so many flavours that <a href="https://mastodon.social/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> is the perfect alternative And it is much more capable of advanced layout like tables and lists and includes

XLBilly<a href="https://graz.social/@publicvoit" class="u-url mention" rel="nofollow noopener" target="_blank">@publicvoit</a> <a href="https://social.vivaldi.net/@ajlewis2" class="u-url mention" rel="nofollow noopener" target="_blank">@ajlewis2</a> <a href="https://pkm.social/@ellane" class="u-url mention" rel="nofollow noopener" target="_blank">@ellane</a> <a href="https://union.place/@feralthoughts" class="u-url mention" rel="nofollow noopener" target="_blank">@feralthoughts</a> <a href="https://c.im/@hbowie" class="u-url mention" rel="nofollow noopener" target="_blank">@hbowie</a> <a href="https://mastodon.social/@reichenstein" class="u-url mention" rel="nofollow noopener" target="_blank">@reichenstein</a> Sadly, LMLs with complex syntax (like Asciidoc, orgmode) only have full support in particular software (Asciidoctor, Emacs). While markdown which is widely supported is too simple, and its extensions are different across different software (like admonition, python's markdown library and pandoc have different syntax for it).<a href="https://social.vivaldi.net/tags/markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#markdown</a> <a href="https://social.vivaldi.net/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> <a href="https://social.vivaldi.net/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a>

Karl Voit :emacs: :orgmode:<a href="https://social.vivaldi.net/@ajlewis2" class="u-url mention" rel="nofollow noopener" target="_blank">@ajlewis2</a> <a href="https://pkm.social/@ellane" class="u-url mention" rel="nofollow noopener" target="_blank">@ellane</a> <a href="https://union.place/@feralthoughts" class="u-url mention" rel="nofollow noopener" target="_blank">@feralthoughts</a> <a href="https://c.im/@hbowie" class="u-url mention" rel="nofollow noopener" target="_blank">@hbowie</a> <a href="https://mastodon.social/@reichenstein" class="u-url mention" rel="nofollow noopener" target="_blank">@reichenstein</a> Just for clarification: same holds true for any other markup supported by pandoc, not just <a href="https://graz.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a>. However, if you stick with a syntax language that doesn't come with this explosion of flavors, you have less issues converting your data - in some cases you don't even have to convert at all any more.The issue with Markdown is that its original form defined a small minimum of elements and each tool defined its own potentially incompatible extensions. With other <a href="https://graz.social/tags/LML" class="mention hashtag" rel="nofollow noopener" target="_blank">#LML</a>, the "original" or its standard defines the maximum set of elements and therefore, there is no need for "flavors" and no data loss or conversion effort.HTH<a href="https://graz.social/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> <a href="https://graz.social/tags/orgmode" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgmode</a> <a href="https://graz.social/tags/orgdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#orgdown</a> <a href="https://graz.social/tags/Obsidian" class="mention hashtag" rel="nofollow noopener" target="_blank">#Obsidian</a> <a href="https://graz.social/tags/PIM" class="mention hashtag" rel="nofollow noopener" target="_blank">#PIM</a>

readbeanicecreamManage Your Resume with Asciidoctor-pdf<a href="https://readbeanicecream.surge.sh/2025/02/17/manage-your-resume-with-asciidoctor-pdf/" rel="nofollow noopener" translate="no" target="_blank">https://readbeanicecream.surge.sh/2025/02/17/manage-your-resume-with-asciidoctor-pdf/</a><a href="https://mastodon.social/tags/technology" class="mention hashtag" rel="nofollow noopener" target="_blank">#technology</a> <a href="https://mastodon.social/tags/tech" class="mention hashtag" rel="nofollow noopener" target="_blank">#tech</a> <a href="https://mastodon.social/tags/careers" class="mention hashtag" rel="nofollow noopener" target="_blank">#careers</a> <a href="https://mastodon.social/tags/work" class="mention hashtag" rel="nofollow noopener" target="_blank">#work</a> <a href="https://mastodon.social/tags/resume" class="mention hashtag" rel="nofollow noopener" target="_blank">#resume</a> <a href="https://mastodon.social/tags/technicalwriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#technicalwriting</a> <a href="https://mastodon.social/tags/jobhunt" class="mention hashtag" rel="nofollow noopener" target="_blank">#jobhunt</a> <a href="https://mastodon.social/tags/jobsearch" class="mention hashtag" rel="nofollow noopener" target="_blank">#jobsearch</a> <a href="https://mastodon.social/tags/markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#markdown</a> <a href="https://mastodon.social/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> <a href="https://mastodon.social/tags/indieweb" class="mention hashtag" rel="nofollow noopener" target="_blank">#indieweb</a> <a href="https://mastodon.social/tags/smallweb" class="mention hashtag" rel="nofollow noopener" target="_blank">#smallweb</a> <a href="https://mastodon.social/tags/opensource" class="mention hashtag" rel="nofollow noopener" target="_blank">#opensource</a>

SynxSuche eine Stelle als techn. Redakteurin im GR Nürnberg oder remote.Arbeite aktuell in der SW-Doku (v.a. <a href="https://troet.cafe/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a>, MS-Office), bin als Quereinsteiger mit Physikstudium, Testinghintergrund und Reqiurementsengineering breit aufgestellt und in der Tekom engagiert. Ich arbeite mich schnell in neue Themen, Techniken und Tools ein und bin für (beinahe) jedes Thema zu begeistern. Freue mich auf Fragen, Angebote, Hinweise und Teilen des Beitrags. <a href="https://troet.cafe/tags/Nurnberg" class="mention hashtag" rel="nofollow noopener" target="_blank">#Nurnberg</a> <a href="https://troet.cafe/tags/fuerth" class="mention hashtag" rel="nofollow noopener" target="_blank">#fuerth</a> <a href="https://troet.cafe/tags/erlangen" class="mention hashtag" rel="nofollow noopener" target="_blank">#erlangen</a> <a href="https://troet.cafe/tags/fedijobs" class="mention hashtag" rel="nofollow noopener" target="_blank">#fedijobs</a> <a href="https://troet.cafe/tags/fedihired" class="mention hashtag" rel="nofollow noopener" target="_blank">#fedihired</a>

Alexander SchwartzThe recording is now available for the <a href="https://fosstodon.org/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> talk at <a href="https://fosstodon.org/tags/fosdem" class="mention hashtag" rel="nofollow noopener" target="_blank">#fosdem</a>! <a href="https://fosdem.org/2025/schedule/event/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem/" rel="nofollow noopener" translate="no" target="_blank">https://fosdem.org/2025/schedule/event/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem/</a><a href="https://pouet.chapril.org/@themr0c" class="u-url mention" rel="nofollow noopener" target="_blank">@themr0c</a>

Fabrice Flore<a href="https://fosstodon.org/@ahus1" class="u-url mention" rel="nofollow noopener" target="_blank">@ahus1</a> presenting <a href="https://pouet.chapril.org/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> evolution into a specification at <a href="https://pouet.chapril.org/tags/fosdem" class="mention hashtag" rel="nofollow noopener" target="_blank">#fosdem</a> <a href="https://pouet.chapril.org/tags/toolthedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#toolthedocs</a>

Thomas D.Recreated the book "Condiments, Spices and Flavors" by Mary Elizabeth Green in Asciidoc format. This is the resulting webpage generated by Asciidoctor: <a href="https://condiments-spices-flavors.pages.dev/" rel="nofollow noopener" translate="no" target="_blank">https://condiments-spices-flavors.pages.dev/</a>Used the book source from Project Gutenberg. <a href="https://mastodon.social/@gutenberg_org" class="u-url mention" rel="nofollow noopener" target="_blank">@gutenberg_org</a> <a href="https://mastodon.social/@EclipseFdn" class="u-url mention" rel="nofollow noopener" target="_blank">@EclipseFdn</a> <a href="https://mastodontech.de/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> <a href="https://mastodontech.de/tags/ebook" class="mention hashtag" rel="nofollow noopener" target="_blank">#ebook</a> <a href="https://mastodontech.de/tags/opensource" class="mention hashtag" rel="nofollow noopener" target="_blank">#opensource</a>

shulhan<a href="https://hachyderm.io/@bbatsov" class="u-url mention" rel="nofollow noopener" target="_blank">@bbatsov</a>Thanks for the article.As a fan of <a href="https://fosstodon.org/tags/asciidoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#asciidoc</a> itself that write native parser for <a href="https://fosstodon.org/tags/golang" class="mention hashtag" rel="nofollow noopener" target="_blank">#golang</a> [1] this specification will help me and others in the future. (I also take notes when reverse engineered the syntax into _my own_ specs here [2]).[1]: <a href="https://git.sr.ht/~shulhan/asciidoctor-go" rel="nofollow noopener" translate="no" target="_blank">https://git.sr.ht/~shulhan/asciidoctor-go</a> [2]: <a href="https://git.sr.ht/~shulhan/asciidoctor-go/tree/main/item/_doc/SPECS.adoc" rel="nofollow noopener" translate="no" target="_blank">https://git.sr.ht/~shulhan/asciidoctor-go/tree/main/item/_doc/SPECS.adoc</a>

Bozhidar Batsov (a.k.a. Bug)It’s always funny when you search for something only to find an article written by you on the subject. In my case that was <a href="https://batsov.com/articles/2024/02/22/asciidoc-language-specification/" rel="nofollow noopener" translate="no" target="_blank">https://batsov.com/articles/2024/02/22/asciidoc-language-specification/</a>I will congratulate myself of writing an excellent article about the state of the <a href="https://hachyderm.io/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> specification efforts!

tobru 🇨🇭 🧑‍🚒<a href="https://chaos.social/@dasrecht" class="u-url mention" rel="nofollow noopener" target="_blank">@dasrecht</a> I'd love if it could understand <a href="https://mstdn.social/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> 😁

Alexander Schwartz"Evolving real-world <a href="https://fosstodon.org/tags/AsciiDoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#AsciiDoc</a> into a specification and how it will help the ecosystem" Re-watch my talk talk at the <a href="https://fosstodon.org/tags/OCX" class="mention hashtag" rel="nofollow noopener" target="_blank">#OCX</a> conference! <a href="https://www.youtube.com/watch?v=jiEz69wYLtM&list=PLy7t4z5SYNaSIOuDW_Z-lXaV5VYVlNGLd&index=29&ab_channel=EclipseFoundation" rel="nofollow noopener" translate="no" target="_blank">https://www.youtube.com/watch?v=jiEz69wYLtM&list=PLy7t4z5SYNaSIOuDW_Z-lXaV5VYVlNGLd&index=29&ab_channel=EclipseFoundation</a>

Frühere Suchanfragen

Suchoptionen

Verwaltet von:

Serverstatistik:

#asciidoc