<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/"><channel><title>Markdown on Tufte Hugo</title><link>https://massimo-nocentini.github.io/tufte.hugo/tags/markdown/</link><description>Recent content in Markdown on Tufte Hugo</description><generator>Hugo</generator><language>en-US</language><lastBuildDate>Tue, 06 Oct 2026 09:00:00 +0200</lastBuildDate><atom:link href="https://massimo-nocentini.github.io/tufte.hugo/tags/markdown/index.xml" rel="self" type="application/rss+xml"/><item><title>Footnotes and Sidenotes</title><link>https://massimo-nocentini.github.io/tufte.hugo/posts/footnotes-and-sidenotes/</link><pubDate>Tue, 06 Oct 2026 09:00:00 +0200</pubDate><dc:creator>Massimo Nocentini</dc:creator><guid>https://massimo-nocentini.github.io/tufte.hugo/posts/footnotes-and-sidenotes/</guid><description>&lt;p&gt;&lt;span class="newthought"&gt;A printed page&lt;/span&gt; can carry two kinds of&#10;note at once: short asides in the margin and longer notes at the foot of the&#10;page.&lt;label for="sn-4e771b-1" class="margin-toggle sidenote-number"&gt;&lt;/label&gt;&lt;input type="checkbox" id="sn-4e771b-1" class="margin-toggle"/&gt;&lt;span class="sidenote"&gt;Sidenotes are numbered 1, 2, 3 … by Tufte CSS&amp;rsquo;s counter.&lt;/span&gt;&#10;This page does the same. Its front matter sets &lt;code&gt;footnoteplacement: section&lt;/code&gt;, so&#10;the real footnotes of each section are listed at the end of that&#10;section.&lt;/p&gt;</description></item><item><title>Footnotes as Sidenotes</title><link>https://massimo-nocentini.github.io/tufte.hugo/posts/footnotes-as-sidenotes/</link><pubDate>Mon, 05 Oct 2026 09:00:00 +0200</pubDate><dc:creator>Massimo Nocentini</dc:creator><guid>https://massimo-nocentini.github.io/tufte.hugo/posts/footnotes-as-sidenotes/</guid><description>&lt;p&gt;&lt;span class="newthought"&gt;Footnotes are the most portable&lt;/span&gt; way to write a note in Markdown: every editor previews them, every converter understands them, and they survive a move to another blog engine.&lt;label for="sn-55eb2e-fnref-1" class="margin-toggle sidenote-number"&gt;&lt;/label&gt;&lt;input type="checkbox" id="sn-55eb2e-fnref-1" class="margin-toggle"/&gt;&lt;span class="sidenote"&gt;CommonMark has no footnotes, but GitHub, Pandoc, MultiMarkdown, Obsidian and Goldmark all accept the same &lt;code&gt;[^label]&lt;/code&gt; syntax.&lt;/span&gt; Sidenotes are the better way to &lt;em&gt;read&lt;/em&gt; a note. This theme lets you write the first and publish the second.&lt;/p&gt;&#10;&lt;p&gt;Hugo renders footnotes as a superscript link in the text and a numbered list at the end of the page.&lt;label for="sn-55eb2e-fnref-2" class="margin-toggle sidenote-number"&gt;&lt;/label&gt;&lt;input type="checkbox" id="sn-55eb2e-fnref-2" class="margin-toggle"/&gt;&lt;span class="sidenote"&gt;Footnotes come from Goldmark&amp;rsquo;s &lt;em&gt;footnote&lt;/em&gt; extension, which Hugo enables by default.&lt;/span&gt; After Hugo has rendered the page, the theme rewrites that output: each reference becomes the label, checkbox and &lt;code&gt;span.sidenote&lt;/code&gt; that Tufte CSS expects, the note text is moved next to its reference, and the list at the bottom is removed.&lt;/p&gt;</description></item></channel></rss>