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

Fabien LOISON (FLOZz)🚀️ rst2gemtext v0.5.0 released!I just released a new version of my lib to convert reStructuredText to Gemtext (the Gemini markup language).➡️ <a href="https://github.com/flozz/rst2gemtext/releases/tag/v0.5.0" rel="nofollow noopener" translate="no" target="_blank">https://github.com/flozz/rst2gemtext/releases/tag/v0.5.0</a>This version fixes an ImportError with newer versions of docutils and improved the outputed gemtext.<a href="https://mastodon.social/tags/python" class="mention hashtag" rel="nofollow noopener" target="_blank">#python</a> <a href="https://mastodon.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> <a href="https://mastodon.social/tags/gemini" class="mention hashtag" rel="nofollow noopener" target="_blank">#gemini</a> <a href="https://mastodon.social/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenSource</a>

bignose<a href="https://fosstodon.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a>, which pre-dates <a href="https://fosstodon.org/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a>, has always been superior for my purposes <a href="https://fosstodon.org/@danielittlewood" class="u-url mention" rel="nofollow noopener" target="_blank">@danielittlewood</a>.<a href="https://www.docutils.org/rst.html" rel="nofollow noopener" translate="no" target="_blank">https://www.docutils.org/rst.html</a>

GlyphTwisted's coding standard for our <a href="https://mastodon.social/tags/ReStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#ReStructuredText</a> files is to use what we have termed "semantic newlines". That is to say: every sentence is on its own line. In principle, I like this. It means smaller, more readable diffs, and less pointless churn. In practice, with my <a href="https://mastodon.social/tags/Emacs" class="mention hashtag" rel="nofollow noopener" target="_blank">#Emacs</a> fill-paragraph muscle memory, it is a *constant* frustrating exercise where I'm tripping over myself and either constantly re-wrapping and then manually un-wrapping, or forgetting to wrap at all.

Jani NikulaHawkmoth v0.20 is out!Hawkmoth is a Sphinx extension to import C and C++ documentation comments into Sphinx based documentation.The main new feature in this release is automatic configuration of the system header search paths. Unfortunately, libclang does not get them right out of the box on most distros, so we have to help it a little.<a href="https://fosstodon.org/tags/Sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sphinx</a> <a href="https://fosstodon.org/tags/Hawkmoth" class="mention hashtag" rel="nofollow noopener" target="_blank">#Hawkmoth</a> <a href="https://fosstodon.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#Documentation</a> <a href="https://fosstodon.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> <a href="https://fosstodon.org/tags/C" class="mention hashtag" rel="nofollow noopener" target="_blank">#C</a><a href="https://github.com/jnikula/hawkmoth" rel="nofollow noopener" translate="no" target="_blank">https://github.com/jnikula/hawkmoth</a>

Wolfgang MaierReturning to writing documentation with <a href="https://fediscience.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> and <a href="https://fediscience.org/tags/sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#sphinx</a> after many years of using only <a href="https://fediscience.org/tags/markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#markdown</a> -- what a way to spend a beautiful spring day 😵

Paul 夏央 KishimotoWhen writing plain-text files with collaborators, such as…- <a href="https://scholar.social/tags/LaTeX" class="mention hashtag" rel="nofollow noopener" target="_blank">#LaTeX</a>, for instance on <a href="https://scholar.social/tags/Overleaf" class="mention hashtag" rel="nofollow noopener" target="_blank">#Overleaf</a> - <a href="https://scholar.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a>, for instance for use with Sphinx/for <a href="https://fosstodon.org/@readthedocs" class="u-url mention" rel="nofollow noopener" target="_blank">@readthedocs</a> - <a href="https://scholar.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> for many purposes.…a practice I find very helpful is to:1. Start every sentence on a new line, and 2. Not hard-wrap within sentences.This makes it MUCH easier to read ordinary diffs and interpret the addition/removal/reordering of sentences, words, paragraphs, etc.

Andrew WoodsRestructuredText is more powerful, and full featured than Markdown. Everyone should be using RestructuredText instead of Markdown for their documents and Static Site Generators.<a href="https://phpc.social/tags/RestructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#RestructuredText</a> <a href="https://phpc.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> <a href="https://phpc.social/tags/SSG" class="mention hashtag" rel="nofollow noopener" target="_blank">#SSG</a> <a href="https://phpc.social/tags/WebDev" class="mention hashtag" rel="nofollow noopener" target="_blank">#WebDev</a> <a href="https://phpc.social/tags/DevLife" class="mention hashtag" rel="nofollow noopener" target="_blank">#DevLife</a>

Fabien LOISON (FLOZz)🚀️ rst2gemtext v0.4.0 released!rst2gemtext is a CLI tool and a <a href="https://mastodon.social/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> library to convert <a href="https://mastodon.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> to <a href="https://mastodon.social/tags/Gemtext" class="mention hashtag" rel="nofollow noopener" target="_blank">#Gemtext</a> (the markup language used by <a href="https://mastodon.social/tags/Gemini" class="mention hashtag" rel="nofollow noopener" target="_blank">#Gemini</a> network).➡️ <a href="https://github.com/flozz/rst2gemtext/releases/tag/v0.4.0" rel="nofollow noopener" translate="no" target="_blank">https://github.com/flozz/rst2gemtext/releases/tag/v0.4.0</a>This release contains mostly fixes on lists of link and tables. Supported Python versions have also been updated. 😃️

Mark Gardner<a href="https://freeradical.zone/@ax6761" class="u-url mention" rel="nofollow noopener" target="_blank">@ax6761</a> <a href="https://a.gup.pe/u/perl" class="u-url mention" rel="nofollow noopener" target="_blank">@perl</a> I sympathize. Would that mean you would author <a href="https://social.sdf.org/tags/Perl" class="mention hashtag" rel="nofollow noopener" target="_blank">#Perl</a> POD but then convert to <a href="https://social.sdf.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> for <a href="https://social.sdf.org/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a>? Because <a href="https://social.sdf.org/tags/Pandoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#Pandoc</a> can already do that as of this week:``` pandoc --from=pod --to=rst ```

pandoc🆕 <a href="https://fosstodon.org/tags/pandoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#pandoc</a> 3.6 has been released: • Support for <a href="https://fosstodon.org/tags/mdoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#mdoc</a> as input format • Improved parsing of <a href="https://fosstodon.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> • <a href="https://fosstodon.org/tags/Typst" class="mention hashtag" rel="nofollow noopener" target="_blank">#Typst</a> 0.12 support • Safe handling of `--embed-resources` when combined with `--sandbox`The default templates for LaTeX, ConTeXt, and Typst have been updated.<a href="https://github.com/jgm/pandoc/releases/tag/3.6" rel="nofollow noopener" translate="no" target="_blank">https://github.com/jgm/pandoc/releases/tag/3.6</a>

FeohThinking about transitioning my <a href="https://oldbytes.space/tags/blogging" class="mention hashtag" rel="nofollow noopener" target="_blank">#blogging</a> from <a href="https://oldbytes.space/tags/nikola" class="mention hashtag" rel="nofollow noopener" target="_blank">#nikola</a> to <a href="https://oldbytes.space/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#mkdocs</a> Nikola is great but I've always felt like writing in Markdown is an also ran use case, as its native lingua franca is my long time nemesis <a href="https://oldbytes.space/tags/restructuredtext" class="mention hashtag" rel="nofollow noopener" target="_blank">#restructuredtext</a> (Hate hate HATE! :) ).mkdocs is built from the ground up to be super simple. Give it a pile of Markdown and it'll generate a site. There's a nice plugin for generating a blog:<a href="https://github.com/squidfunk/mkdocs-material/blob/master/docs/setup/setting-up-a-blog.md" rel="nofollow noopener" translate="no" target="_blank">https://github.com/squidfunk/mkdocs-material/blob/master/docs/setup/setting-up-a-blog.md</a>

Paolo MelchiorreSphinx 8.1.0 has just been released 🎉 Sphinx makes it easy to create intelligent and beautiful documentation. ✨ See here the changelog 👇 <a href="https://www.sphinx-doc.org/en/master/changes/index.html#release-8-1-0-released-oct-10-2024" rel="nofollow noopener" translate="no" target="_blank">https://www.sphinx-doc.org/en/master/changes/index.html#release-8-1-0-released-oct-10-2024</a><a href="https://fosstodon.org/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://fosstodon.org/tags/Sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sphinx</a> <a href="https://fosstodon.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#Documentation</a> <a href="https://fosstodon.org/tags/Generator" class="mention hashtag" rel="nofollow noopener" target="_blank">#Generator</a> <a href="https://fosstodon.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> <a href="https://fosstodon.org/tags/MyST" class="mention hashtag" rel="nofollow noopener" target="_blank">#MyST</a> <a href="https://fosstodon.org/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a>

Matěj Cepl 🇪🇺 🇨🇿 🇺🇦<a href="https://mastodon.kurau.tokyo/@kurau" class="u-url mention" rel="nofollow noopener" target="_blank">@kurau</a> <a href="https://getpelican.com/" rel="nofollow noopener" translate="no" target="_blank">https://getpelican.com/</a>I like <a href="https://floss.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a>, so this is the best one for me (but it can do <a href="https://floss.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> these days as well).<a href="https://floss.social/tags/OpenWeb" class="mention hashtag" rel="nofollow noopener" target="_blank">#OpenWeb</a> <a href="https://floss.social/tags/Blog" class="mention hashtag" rel="nofollow noopener" target="_blank">#Blog</a> <a href="https://floss.social/tags/SmallWeb" class="mention hashtag" rel="nofollow noopener" target="_blank">#SmallWeb</a>

Hugo van Kemenade🚀🖊️ Just released: Sphinx Lint 1.0.0You can add it to your pre-commit to help find nits in your reStructuredText docs.<a href="https://pypi.org/project/sphinx-lint/" rel="nofollow noopener" translate="no" target="_blank">https://pypi.org/project/sphinx-lint/</a><a href="https://github.com/sphinx-contrib/sphinx-lint/releases/tag/v1.0.0" rel="nofollow noopener" translate="no" target="_blank">https://github.com/sphinx-contrib/sphinx-lint/releases/tag/v1.0.0</a><a href="https://mastodon.social/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> <a href="https://mastodon.social/tags/docs" class="mention hashtag" rel="nofollow noopener" target="_blank">#docs</a> <a href="https://mastodon.social/tags/SphinxLint" class="mention hashtag" rel="nofollow noopener" target="_blank">#SphinxLint</a> <a href="https://mastodon.social/tags/Sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#Sphinx</a> <a href="https://mastodon.social/tags/lint" class="mention hashtag" rel="nofollow noopener" target="_blank">#lint</a> <a href="https://mastodon.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> <a href="https://mastodon.social/tags/reST" class="mention hashtag" rel="nofollow noopener" target="_blank">#reST</a> <a href="https://mastodon.social/tags/rst" class="mention hashtag" rel="nofollow noopener" target="_blank">#rst</a> <a href="https://mastodon.social/tags/precommit" class="mention hashtag" rel="nofollow noopener" target="_blank">#precommit</a>

Mark Gardner<a href="https://mendeddrum.org/@pdcawley" class="u-url mention" rel="nofollow noopener" target="_blank">@pdcawley</a> <a href="https://social.sdf.org/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a> acknowledges its <a href="https://social.sdf.org/tags/Textile" class="mention hashtag" rel="nofollow noopener" target="_blank">#Textile</a>, <a href="https://social.sdf.org/tags/Setext" class="mention hashtag" rel="nofollow noopener" target="_blank">#Setext</a>, <a href="https://social.sdf.org/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a>, et al influences but prioritizes human readability more: <a href="https://daringfireball.net/projects/markdown/syntax#philosophy" rel="nofollow noopener" translate="no" target="_blank">https://daringfireball.net/projects/markdown/syntax#philosophy</a>

Matěj Cepl 🇪🇺 🇨🇿 🇺🇦<a href="https://hachyderm.io/@bbatsov" class="u-url mention" rel="nofollow noopener" target="_blank">@bbatsov</a> Exactly, if you made research on <a href="https://floss.social/tags/Python" class="mention hashtag" rel="nofollow noopener" target="_blank">#Python</a> programmers, you would get quite different results (we all use <a href="https://floss.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> ).

Matěj Cepl 🇪🇺 🇨🇿 🇺🇦<a href="https://fosstodon.org/@pandoc" class="u-url mention" rel="nofollow noopener" target="_blank">@pandoc</a> Actually, this really looks well! I have never been able to manage to write <a href="https://floss.social/tags/groff" class="mention hashtag" rel="nofollow noopener" target="_blank">#groff</a> documents, but this looks really well with plain <a href="https://floss.social/tags/reStructuredText" class="mention hashtag" rel="nofollow noopener" target="_blank">#reStructuredText</a> (or <a href="https://floss.social/tags/rst" class="mention hashtag" rel="nofollow noopener" target="_blank">#rst</a>) documents.

Karl Voit :emacs: :orgmode:<a href="https://chaos.social/@pludikovsky" class="u-url mention" rel="nofollow noopener" target="_blank">@pludikovsky</a> When people are in favor of <a href="https://graz.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#Markdown</a>, they either do mean the concept of lightweight <a href="https://graz.social/tags/markup" class="mention hashtag" rel="nofollow noopener" target="_blank">#markup</a> languages (<a href="https://graz.social/tags/LML" class="mention hashtag" rel="nofollow noopener" target="_blank">#LML</a>) in general (yeah!) or they do not really know many other LMLs in comparison.Furthermore, people voting for MD often do ignore the obvious downsides of that ecosystem because they have already overcome some of them, ignoring the majority of people who still need to learn that LML in future. 😔 <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/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>

Jarkko Sakkinen<a class="hashtag" href="https://social.kernel.org/tag/pelican" rel="nofollow noopener" target="_blank">#pelican</a> seems to be in sweet spot for me generating a site because it has first-class <a class="hashtag" href="https://social.kernel.org/tag/restructuredtext" rel="nofollow noopener" target="_blank">#reStructuredText</a> support, i.e. no need to add any plugins it is built-in. The benefit in it is that if I write anything with reStructuredText it is easy to port as kernel documentation later on. <a class="hashtag" href="https://social.kernel.org/tag/python" rel="nofollow noopener" target="_blank">#python</a>

Recent searches

Search options

Administered by:

Server stats:

#restructuredtext