<h1 id="reading-2022-02-22">Reading 2022-02-22<a aria-hidden="true" class="anchor-heading icon-link" href="#reading-2022-02-22"></a></h1>
<h2 id="metadata">Metadata<a aria-hidden="true" class="anchor-heading icon-link" href="#metadata"></a></h2>
<ul>
<li>Ref:: <a href="https://www.smashingmagazine.com/2022/02/thoughts-on-markdown/">Smashing Magazine</a></li>
<li>Title:: Thoughts On Markdown</li>
<li>Author:: Knut Melvær</li>
<li>Year of publication:: 2022</li>
<li>Category:: Blog</li>
<li>Topic::</li>
<li>Related::
<ul>
<li><a href="https://news.ycombinator.com/item?id=30395130">Hacker News | Thoughts On Markdown</a></li>
<li><a href="https://news.ycombinator.com/item?id=27744509">Hacker News | Compare AsciiDoc to Markdown</a></li>
<li><a href="https://news.ycombinator.com/item?id=30745524">Hacker News | Plaintext Productivity</a></li>
<li><a href="https://www.reddit.com/r/technicalwriting/comments/qxcsx6/markdown_vs_asciidoc/">Reddit | Markdown vs Asciidoc</a></li>
<li><a href="https://myst-parser.readthedocs.io/en/latest/">MyST - Markedly Structured Text</a></li>
<li><a href="https://github.com/dendronhq/dendron/discussions/2347#discussioncomment-2277719">Dendron discussion</a></li>
<li><a href="https://karl-voit.at/2017/09/23/orgmode-as-markup-only/">Org Mode Is One of the Most Reasonable Markup Languages to Use for Text</a></li>
</ul>
</li>
</ul>
<h2 id="notes-from-reading">Notes from reading<a aria-hidden="true" class="anchor-heading icon-link" href="#notes-from-reading"></a></h2>
<p><a href="https://docs.asciidoctor.org/asciidoc/latest/asciidoc-vs-markdown/">Compare AsciiDoc vs Markdown</a></p>
<p>Markdown: </p>
<ul>
<li>was created to make the source readable</li>
<li>was an attempt to take all of those community-accepted formatting conventions and standardize it into a single format</li>
<li>is a formalisation of conventions which were in common in email &#x26; news long before HTML even existed</li>
</ul>
<p>The main advantages of AsciiDoc:</p>
<ul>
<li>more flexible/powerful formatting options</li>
<li>letting you implement a ton of structural/metadata type stuff with a syntax that is more complicated than Markdown but far simpler than XML</li>
</ul>
<p>MyST - Markedly Structured Text:</p>
<ul>
<li>extending CommonMark to merge with a lot of the strengths from reStructuredText</li>
<li>implement <a href="https://myst-parser.readthedocs.io/en/latest/syntax/syntax.html#directives-a-block-level-extension-point">directives</a> in Markdown as a standard format for special properties to things like images, admonitions, and for entry points for plugins to integrate well directly within the Markdown</li>
</ul>
<hr>
<strong>Backlinks</strong>
<ul>
<li><a href="/notes/vvqWsP14qir4piOwoTAaW">Markdown</a></li>
</ul>

Thoughts on Markdown

h7b-dendron

# Hey 👋

Welcome to my [digital garden](https://maggieappleton.com/garden-history).

I use this as a frictionless way to
- communicate my thoughts via blog post
- quickly reference my notes.

If you've got any questions or interesting technical problems, please reach out to
- email: `h(at)kool(dot)casa` 
- or start a [discussion in GitHub](https://github.com/h7b/h7b-dendron-netlify/discussions/1).

Huy (he/him)