<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title>sakrishive</title>
  <subtitle>sakrishive is a community where you can meet people who actually get it and do better work together, more efficiently. Intelligence doesn&#39;t have to be alone.</subtitle>
  <link href="https://sakrishive.org/feed.xml" rel="self"/>
  <link href="https://sakrishive.org/"/>
    <updated>2026-01-19T00:00:00Z</updated>
  <id>https://sakrishive.org</id>
  <author>
    <name>skolarla</name>
    <email>skolarla@proton.me</email>
  </author>
    <entry>
      <title>Markdown and Eleventy Reference Template</title>
      <link href="https://sakrishive.org/posts/markdown-and-eleventy-reference-template/"/>
      <updated>2026-01-19T00:00:00Z</updated>
      <id>https://sakrishive.org/posts/markdown-and-eleventy-reference-template/</id>
      <content type="html">
        <![CDATA[
      <p><a id="toc"></a></p>
<h2>Table of Contents</h2>
<h3>Most-used basics</h3>
<ul>
<li><a href="#preserving-leading-spaces">Preserving leading spaces in Markdown/HTML</a></li>
<li><a href="#creating-headings-and-section-anchors">Creating headings and section anchors</a></li>
<li><a href="#linking-to-sections-and-external-pages">Linking to sections and external pages</a></li>
<li><a href="#writing-lists-bullets-numbers-nesting">Writing lists (bullets, numbers, nesting)</a></li>
<li><a href="#writing-code-inline-and-in-blocks">Writing code inline and in blocks</a></li>
<li><a href="#adding-images-inside-text">Adding images inside text</a></li>
</ul>
<h3>Writing and formatting helpers</h3>
<ul>
<li><a href="#writing-blockquotes-and-simple-callouts">Writing blockquotes and simple callouts</a></li>
<li><a href="#writing-task-lists">Writing task lists</a></li>
<li><a href="#writing-keyboard-shortcuts">Writing keyboard shortcuts</a></li>
<li><a href="#writing-tables">Writing tables</a></li>
<li><a href="#writing-footnotes">Writing footnotes</a></li>
<li><a href="#writing-math-with-latex">Writing math with LaTeX</a></li>
<li><a href="#collapsible-sections-detailssummary">Collapsible sections (details/summary)</a></li>
<li><a href="#escaping-special-characters">Escaping special characters</a></li>
</ul>
<h3>Technical extras</h3>
<ul>
<li><a href="#advanced-code-fences">Advanced code fences</a></li>
<li><a href="#handling-very-long-code-lines">Handling very long code lines</a></li>
<li><a href="#horizontal-rules-markdown-and-html">Horizontal rules (Markdown and HTML)</a></li>
<li><a href="#reference-style-links">Reference-style links</a></li>
</ul>
<h3>Rich media</h3>
<ul>
<li><a href="#embedding-video">Embedding video</a></li>
<li><a href="#embedding-audio">Embedding audio</a></li>
<li><a href="#using-mermaid-diagrams">Using Mermaid diagrams</a></li>
</ul>
<h3>Eleventy front matter</h3>
<ul>
<li><a href="#eleventy-front-matter-reference">Eleventy front matter reference</a></li>
</ul>
<h3>Ready-to-paste snippets</h3>
<ul>
<li><a href="#snippets-library">Snippets library</a></li>
</ul>
<hr>
<p><a id="preserving-leading-spaces"></a></p>
<h2>Preserving leading spaces in Markdown/HTML</h2>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token entity named-entity" title="&nbsp;">&amp;nbsp;</span><span class="token entity named-entity" title="&nbsp;">&amp;nbsp;</span><span class="token entity named-entity" title="&nbsp;">&amp;nbsp;</span><span class="token entity named-entity" title="&nbsp;">&amp;nbsp;</span>Your text here</code></pre>
<p><code>&amp;nbsp;</code> is a non-breaking space; repeating it forces visible indentation in HTML-capable Markdown when normal leading spaces would be collapsed/trimmed.</p>
<p><a id="creating-headings-and-section-anchors"></a></p>
<h2>Creating headings and section anchors</h2>
<h3>Option A: rely on automatic heading slugs</h3>
<p>Most renderers generate an id from the heading text.</p>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token title important"><span class="token punctuation">##</span> My Section Title</span>

Jump to it: <span class="token url">[<span class="token content">go</span>](<span class="token url">#my-section-title</span>)</span></code></pre>
<h3>Option B: force a stable id using HTML (most reliable)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>h2</span> <span class="token attr-name">id</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>my-section<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>My Section Title<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>h2</span><span class="token punctuation">></span></span></code></pre>
<p>Link:</p>
<pre class="language-md"><code class="language-md"><span class="token url">[<span class="token content">go</span>](<span class="token url">#my-section</span>)</span></code></pre>
<h3>Option C: add an explicit anchor before a normal heading</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>a</span> <span class="token attr-name">id</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>my-section<span class="token punctuation">"</span></span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>a</span><span class="token punctuation">></span></span>
<span class="token title important"><span class="token punctuation">##</span> My Section Title</span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="linking-to-sections-and-external-pages"></a></p>
<h2>Linking to sections and external pages</h2>
<h3>Link to a section on the same page</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Jump: <span class="token url">[<span class="token content">go to anchors</span>](<span class="token url">#creating-headings-and-section-anchors</span>)</span></code></pre>
<h3>Link to another page</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Read the docs: <span class="token url">[<span class="token content">Docs</span>](<span class="token url">/docs/</span>)</span></code></pre>
<h3>HTML link (when you need extra attributes)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>a</span> <span class="token attr-name">href</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>https://example.com<span class="token punctuation">"</span></span> <span class="token attr-name">target</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>_blank<span class="token punctuation">"</span></span> <span class="token attr-name">rel</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>noopener noreferrer<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Open in a new tab<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>a</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-lists-bullets-numbers-nesting"></a></p>
<h2>Writing lists (bullets, numbers, nesting)</h2>
<h3>Bullet list</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token list punctuation">-</span> One
<span class="token list punctuation">-</span> Two
<span class="token list punctuation">-</span> Three</code></pre>
<h3>Numbered list</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token list punctuation">1.</span> First
<span class="token list punctuation">2.</span> Second
<span class="token list punctuation">3.</span> Third</code></pre>
<h3>Nested list</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token list punctuation">-</span> Parent item
  <span class="token list punctuation">-</span> Child item
  <span class="token list punctuation">-</span> Another child
    <span class="token list punctuation">-</span> Grandchild</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-code-inline-and-in-blocks"></a></p>
<h2>Writing code inline and in blocks</h2>
<h3>Inline code</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Use the <span class="token code-snippet code keyword">`npm run build`</span> command.</code></pre>
<h3>Code block with syntax highlighting</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js</span>
<span class="token code-block language-js">console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'hello'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></span>
<span class="token punctuation">```</span></span></code></pre>
<h3>Code block without a language</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span>
<span class="token code-block">Plain code block.</span>
<span class="token punctuation">```</span></span></code></pre>
<h3>HTML version (when Markdown is being annoying)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>pre</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>code</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>language-js<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>console.log('hello');<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>code</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>pre</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="adding-images-inside-text"></a></p>
<h2>Adding images inside text</h2>
<h3>Basic image</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Here is an image in the middle of a paragraph.

<span class="token url"><span class="token operator">!</span>[<span class="token content">Alt text describing the image</span>](<span class="token url">/images/example.png</span>)</span></code></pre>
<h3>Image with a caption (HTML)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>figure</span><span class="token punctuation">></span></span>
  <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>img</span> <span class="token attr-name">src</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>/images/example.png<span class="token punctuation">"</span></span> <span class="token attr-name">alt</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>Alt text describing the image<span class="token punctuation">"</span></span> <span class="token punctuation">/></span></span>
  <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>figcaption</span><span class="token punctuation">></span></span>Caption text goes here.<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>figcaption</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>figure</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-blockquotes-and-simple-callouts"></a></p>
<h2>Writing blockquotes and simple callouts</h2>
<h3>Plain blockquote</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token blockquote punctuation">></span> This is a quote.
<span class="token blockquote punctuation">></span> It can span multiple lines.</code></pre>
<h3>Portable callout style</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token blockquote punctuation">></span> <span class="token bold"><span class="token punctuation">**</span><span class="token content">Note:</span><span class="token punctuation">**</span></span> This is a note.</code></pre>
<h3>Renderer-specific callout (only if supported)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token blockquote punctuation">></span> [!TIP]
<span class="token blockquote punctuation">></span> This is a tip.</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-task-lists"></a></p>
<h2>Writing task lists</h2>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token list punctuation">-</span> [ ] Not done yet
<span class="token list punctuation">-</span> [x] Done
  <span class="token list punctuation">-</span> [ ] Nested task (renderer-dependent)</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-keyboard-shortcuts"></a></p>
<h2>Writing keyboard shortcuts</h2>
<h3>HTML (best looking, common in docs)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html">Press <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>kbd</span><span class="token punctuation">></span></span>Ctrl<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>kbd</span><span class="token punctuation">></span></span> + <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>kbd</span><span class="token punctuation">></span></span>C<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>kbd</span><span class="token punctuation">></span></span>.</code></pre>
<h3>Markdown fallback</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Press <span class="token code-snippet code keyword">`Ctrl`</span> + <span class="token code-snippet code keyword">`C`</span>.</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-tables"></a></p>
<h2>Writing tables</h2>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token table"><span class="token table-header-row"><span class="token punctuation">|</span><span class="token table-header important"> Col A </span><span class="token punctuation">|</span><span class="token table-header important"> Col B </span><span class="token punctuation">|</span><span class="token table-header important"> Col C </span><span class="token punctuation">|</span>
</span><span class="token table-line"><span class="token punctuation">|</span><span class="token punctuation">------:</span><span class="token punctuation">|</span><span class="token punctuation">:------</span><span class="token punctuation">|</span><span class="token punctuation">:-----:</span><span class="token punctuation">|</span>
</span><span class="token table-data-rows"><span class="token punctuation">|</span><span class="token table-data"> 123   </span><span class="token punctuation">|</span><span class="token table-data"> left  </span><span class="token punctuation">|</span><span class="token table-data"> mid   </span><span class="token punctuation">|</span>
<span class="token punctuation">|</span><span class="token table-data"> 4     </span><span class="token punctuation">|</span><span class="token table-data"> text  </span><span class="token punctuation">|</span><span class="token table-data"> ok    </span><span class="token punctuation">|</span>
</span></span></code></pre>
<p><strong>Rendered</strong>:</p>
<table>
<thead>
<tr>
<th style="text-align:right">Col A</th>
<th style="text-align:left">Col B</th>
<th style="text-align:center">Col C</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:right">123</td>
<td style="text-align:left">left</td>
<td style="text-align:center">mid</td>
</tr>
<tr>
<td style="text-align:right">4</td>
<td style="text-align:left">text</td>
<td style="text-align:center">ok</td>
</tr>
</tbody>
</table>
<p>Notes:</p>
<ul>
<li><code>---:</code> right-align, <code>:---</code> left-align, <code>:---:</code> center.</li>
</ul>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-footnotes"></a></p>
<h2>Writing footnotes</h2>
<p>If your renderer supports footnotes:</p>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">This sentence needs a footnote.[^1]

<span class="token url-reference url"><span class="token punctuation">[</span><span class="token variable">^1</span><span class="token punctuation">]</span><span class="token punctuation">:</span> This</span> is the footnote text.</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="writing-math-with-latex"></a></p>
<h2>Writing math with LaTeX</h2>
<h3>Inline math (renderer-dependent)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Einstein: $E=mc^2$</code></pre>
<h3>Block math (renderer-dependent)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$</code></pre>
<h3>Fallback when LaTeX is not supported</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token code-snippet code keyword">`E=mc^2`</span>

<span class="token code"><span class="token punctuation">```</span><span class="token code-language">text</span>
<span class="token code-block language-text">sum(i=1..n) i = n(n+1)/2</span>
<span class="token punctuation">```</span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="collapsible-sections-detailssummary"></a></p>
<h2>Collapsible sections (details/summary)</h2>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>details</span><span class="token punctuation">></span></span>
  <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>summary</span><span class="token punctuation">></span></span>Show more<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>summary</span><span class="token punctuation">></span></span>

  Hidden content goes here.
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>details</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="escaping-special-characters"></a></p>
<h2>Escaping special characters</h2>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">\*This will not be italic\*
\# This will not become a heading
\[This will not become a link\]

Use <span class="token code-snippet code keyword">`*`</span> for emphasis.</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="advanced-code-fences"></a></p>
<h2>Advanced code fences</h2>
<h3>Use tildes if your content includes lots of backticks</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">~<span class="token strike"><span class="token punctuation">~~</span><span class="token content">js
console.log('tilde fence');
</span><span class="token punctuation">~~</span></span>~</code></pre>
<h3>Show a literal fenced block inside a fenced block</h3>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">md</span>
<span class="token code-block language-md">```js
console.log('nested');</span>
<span class="token punctuation">```</span></span>
```</code></pre>
<h3>HTML code block (fully manual)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>pre</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>code</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>language-css<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>.btn { padding: 1rem; }<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>code</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>pre</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="handling-very-long-code-lines"></a></p>
<h2>Handling very long code lines</h2>
<p>Long lines are allowed; wrapping depends on your CSS/renderer.</p>
<pre class="language-js"><code class="language-js"><span class="token keyword">const</span> <span class="token function-variable function">toFixed</span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token parameter">n<span class="token punctuation">,</span> fixed</span><span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token operator">~</span><span class="token operator">~</span><span class="token punctuation">(</span>Math<span class="token punctuation">.</span><span class="token function">pow</span><span class="token punctuation">(</span><span class="token number">10</span><span class="token punctuation">,</span> fixed<span class="token punctuation">)</span> <span class="token operator">*</span> n<span class="token punctuation">)</span> <span class="token operator">/</span> Math<span class="token punctuation">.</span><span class="token function">pow</span><span class="token punctuation">(</span><span class="token number">10</span><span class="token punctuation">,</span> fixed<span class="token punctuation">)</span><span class="token punctuation">;</span>

<span class="token comment">// Examples</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.1</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">2</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.19</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">3</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.198</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">4</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.1987</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">5</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.19872</span>
<span class="token function">toFixed</span><span class="token punctuation">(</span><span class="token number">25.198726354</span><span class="token punctuation">,</span> <span class="token number">6</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// 25.198726</span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="horizontal-rules-markdown-and-html"></a></p>
<h2>Horizontal rules (Markdown and HTML)</h2>
<p>Use these inside the body of a file. If <code>---</code> is at the very top of the file, it starts YAML front matter.</p>
<p><strong>Write (Markdown)</strong>:</p>
<pre class="language-md"><code class="language-md"><span class="token hr punctuation">---</span>

<span class="token hr punctuation">***</span>

___</code></pre>
<p><strong>Write (HTML)</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>hr</span> <span class="token punctuation">/></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="reference-style-links"></a></p>
<h2>Reference-style links</h2>
<p>Useful for keeping URLs out of the paragraph.</p>
<p><strong>Write</strong>:</p>
<pre class="language-md"><code class="language-md">Read the <span class="token url">[<span class="token content">Docs</span>][<span class="token variable">docs</span>]</span> and the <span class="token url">[<span class="token content">FAQ</span>][<span class="token variable">faq</span>]</span>.

<span class="token url-reference url"><span class="token punctuation">[</span><span class="token variable">docs</span><span class="token punctuation">]</span><span class="token punctuation">:</span> https://example.com/docs</span>
<span class="token url-reference url"><span class="token punctuation">[</span><span class="token variable">faq</span><span class="token punctuation">]</span><span class="token punctuation">:</span> https://example.com/faq</span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="embedding-video"></a></p>
<h2>Embedding video</h2>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>iframe</span>
  <span class="token attr-name">width</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>560<span class="token punctuation">"</span></span>
  <span class="token attr-name">height</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>315<span class="token punctuation">"</span></span>
  <span class="token attr-name">src</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>https://www.youtube-nocookie.com/embed/Yw6u6YkTgQ4<span class="token punctuation">"</span></span>
  <span class="token attr-name">frameborder</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>0<span class="token punctuation">"</span></span>
  <span class="token attr-name">allow</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture<span class="token punctuation">"</span></span>
  <span class="token attr-name">allowfullscreen</span>
<span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>iframe</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="embedding-audio"></a></p>
<h2>Embedding audio</h2>
<p><strong>Write</strong>:</p>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>iframe</span>
  <span class="token attr-name">width</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>100%<span class="token punctuation">"</span></span>
  <span class="token attr-name">height</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>300<span class="token punctuation">"</span></span>
  <span class="token attr-name">scrolling</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>no<span class="token punctuation">"</span></span>
  <span class="token attr-name">frameborder</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>no<span class="token punctuation">"</span></span>
  <span class="token attr-name">allow</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>autoplay<span class="token punctuation">"</span></span>
  <span class="token attr-name">src</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/422530128&amp;auto_play=false<span class="token punctuation">"</span></span>
<span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>iframe</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="using-mermaid-diagrams"></a></p>
<h2>Using Mermaid diagrams</h2>
<p>Common types (depending on what your setup enables):</p>
<ul>
<li>flowchart</li>
<li>sequenceDiagram</li>
<li>stateDiagram</li>
<li>classDiagram</li>
<li>gantt</li>
<li>pie</li>
</ul>
<h3>Flowchart</h3>
<pre class="language-mermaid"><code class="language-mermaid"><span class="token keyword">graph</span> LR
  A<span class="token text string">[Square]</span> <span class="token arrow operator">--></span> B<span class="token text string">((Circle))</span>
  B <span class="token arrow operator">--></span> C<span class="token text string">{Decision}</span></code></pre>
<h3>Sequence diagram</h3>
<pre class="language-mermaid"><code class="language-mermaid"><span class="token keyword">sequenceDiagram</span>
  <span class="token keyword">participant</span> U as User
  <span class="token keyword">participant</span> S as Site
  U<span class="token arrow operator">->></span>S<span class="token operator">:</span> Request
  S<span class="token arrow operator">-->></span>U<span class="token operator">:</span> Response</code></pre>
<h3>Pie chart</h3>
<pre class="language-mermaid"><code class="language-mermaid"><span class="token keyword">pie</span> title Example
  <span class="token string">"Searching"</span> <span class="token operator">:</span> 90
  <span class="token string">"Watching"</span> <span class="token operator">:</span> 10</code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="eleventy-front-matter-reference"></a></p>
<h2>Eleventy front matter reference</h2>
<p>Eleventy reads YAML front matter between the first <code>---</code> at the top of the file and the next <code>---</code>.</p>
<p><a id="fm-common-fields"></a></p>
<h3>Common fields</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> A post title
<span class="token key atrule">description</span><span class="token punctuation">:</span> One sentence summary.
<span class="token key atrule">date</span><span class="token punctuation">:</span> <span class="token string">'2026-01-19'</span>        <span class="token comment"># or: 2026-01-19</span>
<span class="token key atrule">updated</span><span class="token punctuation">:</span> <span class="token string">'2026-01-20'</span>     <span class="token comment"># optional</span>
<span class="token key atrule">layout</span><span class="token punctuation">:</span> layouts/post.njk  <span class="token comment"># optional</span>

<span class="token key atrule">tags</span><span class="token punctuation">:</span>
  <span class="token punctuation">-</span> demo<span class="token punctuation">-</span>content
  <span class="token punctuation">-</span> docs

<span class="token key atrule">permalink</span><span class="token punctuation">:</span> posts/<span class="token punctuation">{</span><span class="token punctuation">{</span> title <span class="token punctuation">|</span> slug <span class="token punctuation">}</span><span class="token punctuation">}</span>/index.html
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-drafts-and-collections"></a></p>
<h3>Drafts and collection behavior</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> Draft example
<span class="token key atrule">draft</span><span class="token punctuation">:</span> <span class="token boolean important">true</span>
<span class="token comment"># Or exclude from collections entirely:</span>
<span class="token key atrule">eleventyExcludeFromCollections</span><span class="token punctuation">:</span> <span class="token boolean important">true</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-pagination"></a></p>
<h3>Pagination (common pattern)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> Posts index
<span class="token key atrule">layout</span><span class="token punctuation">:</span> layouts/base.njk
<span class="token key atrule">pagination</span><span class="token punctuation">:</span>
  <span class="token key atrule">data</span><span class="token punctuation">:</span> collections.posts
  <span class="token key atrule">size</span><span class="token punctuation">:</span> <span class="token number">10</span>
  <span class="token key atrule">alias</span><span class="token punctuation">:</span> posts
<span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token string">"posts/{{ pagination.pageNumber | plus: 1 }}/index.html"</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-eleventy-navigation"></a></p>
<h3>eleventyNavigation (plugin)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> Resources
<span class="token key atrule">layout</span><span class="token punctuation">:</span> layouts/page.njk
<span class="token key atrule">eleventyNavigation</span><span class="token punctuation">:</span>
  <span class="token key atrule">key</span><span class="token punctuation">:</span> Resources
  <span class="token key atrule">order</span><span class="token punctuation">:</span> <span class="token number">3</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-eleventy-computed"></a></p>
<h3>eleventyComputed (computed values)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"My Post"</span>
<span class="token key atrule">tags</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>posts<span class="token punctuation">]</span>
<span class="token key atrule">eleventyComputed</span><span class="token punctuation">:</span>
  <span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token string">"posts/{{ title | slug }}/index.html"</span>
  <span class="token comment"># Example derived field:</span>
  <span class="token comment"># description: "{{ summary | default('') }}"</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-output-control"></a></p>
<h3>Output control (permalink tricks)</h3>
<p><strong>Write (disable output)</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"No output"</span>
<span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token boolean important">false</span>
<span class="token punctuation">---</span></code></pre>
<p><strong>Write (dynamic permalink)</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"Yearly archive"</span>
<span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token string">"posts/{{ date | date: '%Y' }}/index.html"</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-template-engines"></a></p>
<h3>Template engines (override defaults)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"Render Markdown through Nunjucks"</span>
<span class="token key atrule">markdownTemplateEngine</span><span class="token punctuation">:</span> njk
<span class="token comment"># Or override the template engines for this file:</span>
<span class="token comment"># templateEngineOverride: njk,md</span>
<span class="token comment"># Also possible:</span>
<span class="token comment"># dataTemplateEngine: njk</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-redirects-aliases"></a></p>
<h3>Redirects / aliases (plugin-dependent)</h3>
<p>Eleventy does not ship redirects by default; these keys are commonly used with redirect plugins.</p>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"Moved page"</span>
<span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token string">"/new-url/"</span>
<span class="token key atrule">redirectFrom</span><span class="token punctuation">:</span>
  <span class="token punctuation">-</span> <span class="token string">"/old-url/"</span>
  <span class="token punctuation">-</span> <span class="token string">"/older-url/"</span>
<span class="token comment"># Some setups use `aliases` instead:</span>
<span class="token comment"># aliases:</span>
<span class="token comment">#   - "/old-url/"</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-canonical"></a></p>
<h3>Canonical URL (SEO)</h3>
<p><strong>Write</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"Canonical example"</span>
<span class="token key atrule">canonical</span><span class="token punctuation">:</span> <span class="token string">"https://example.com/posts/canonical-example/"</span>
<span class="token punctuation">---</span></code></pre>
<p><a id="fm-data-files"></a></p>
<h3>Data files (common pattern)</h3>
<p>If you have <code>src/_data/site.json</code>, you can reference it in templates like <code>site.title</code>.</p>
<p><strong>Example</strong>:</p>
<pre class="language-yaml"><code class="language-yaml"><span class="token punctuation">---</span>
<span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"{{ site.title }}"</span>
<span class="token punctuation">---</span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p><a id="snippets-library"></a></p>
<h2>Snippets library</h2>
<h3>New post skeleton (Eleventy + Markdown)</h3>
<pre class="language-md"><code class="language-md"><span class="token front-matter-block"><span class="token punctuation">---</span>
<span class="token front-matter yaml language-yaml"><span class="token key atrule">title</span><span class="token punctuation">:</span> <span class="token string">"Post title"</span>
<span class="token key atrule">description</span><span class="token punctuation">:</span> <span class="token string">"One sentence summary."</span>
<span class="token key atrule">date</span><span class="token punctuation">:</span> <span class="token string">'2026-01-19'</span>
<span class="token key atrule">tags</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>posts<span class="token punctuation">]</span>
<span class="token key atrule">layout</span><span class="token punctuation">:</span> layouts/post.njk
<span class="token key atrule">permalink</span><span class="token punctuation">:</span> <span class="token string">"posts/{{ title | slug }}/index.html"</span></span>
<span class="token punctuation">---</span></span>

<span class="token title important"><span class="token punctuation">##</span> Section title</span>

Text.

<span class="token title important"><span class="token punctuation">###</span> Subsection</span>

<span class="token list punctuation">-</span> Point
<span class="token list punctuation">-</span> Point

<span class="token code"><span class="token punctuation">```</span><span class="token code-language">js</span>
<span class="token code-block language-js language-js">console<span class="token punctuation">.</span><span class="token function">log</span><span class="token punctuation">(</span><span class="token string">'code sample'</span><span class="token punctuation">)</span><span class="token punctuation">;</span></span>
<span class="token punctuation">```</span></span>

<span class="token url">[<span class="token content">Back to top</span>](<span class="token url">#toc</span>)</span></code></pre>
<h3>Code example section skeleton</h3>
<pre class="language-md"><code class="language-md"><span class="token title important"><span class="token punctuation">###</span> What it does</span>

One sentence.

<span class="token bold"><span class="token punctuation">**</span><span class="token content">Write</span><span class="token punctuation">**</span></span>:

<span class="token code"><span class="token punctuation">```</span><span class="token code-language">md</span>
<span class="token code-block language-md language-md">...your example here...</span>
<span class="token punctuation">```</span></span>

<span class="token bold"><span class="token punctuation">**</span><span class="token content">Rendered</span><span class="token punctuation">**</span></span>:

...show output here...</code></pre>
<h3>Image with caption skeleton</h3>
<pre class="language-html"><code class="language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>figure</span><span class="token punctuation">></span></span>
  <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>img</span> <span class="token attr-name">src</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>/images/example.png<span class="token punctuation">"</span></span> <span class="token attr-name">alt</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>Describe the image<span class="token punctuation">"</span></span> <span class="token punctuation">/></span></span>
  <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>figcaption</span><span class="token punctuation">></span></span>Short caption.<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>figcaption</span><span class="token punctuation">></span></span>
<span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>figure</span><span class="token punctuation">></span></span></code></pre>
<p><a href="#toc">Back to TOC</a></p>
<p>Note: &quot;{% raw %} {% endraw %}&quot; is used for this template.</p>

    ]]>
      </content>
    </entry>
</feed>