http://blog.gmora.work/tags/meta/Recent content in Meta on Mora's blogHugoen-USWed, 21 Oct 2026 14:23:41 -0600http://blog.gmora.work/cheatsheets/writing-on-this-blog/Wed, 21 Oct 2026 00:00:00 +0000http://blog.gmora.work/cheatsheets/writing-on-this-blog/<p>Everything is plain Markdown. Write, <code>git push</code>, and the site rebuilds itself on GitHub Pages.</p> <h2 id="new-post">New post <a class="anchor" href="#new-post" aria-label="Link to this section">#</a></h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new posts/my-post/index.md <span class="c1"># a folder per post, so images live next to it</span> </span></span><span class="line"><span class="cl">hugo server <span class="c1"># preview at http://localhost:1313</span> </span></span><span class="line"><span class="cl">git add . <span class="o">&amp;&amp;</span> git commit -m <span class="s2">&#34;New post&#34;</span> <span class="o">&amp;&amp;</span> git push </span></span></code></pre></div><p>A cheatsheet goes in <code>content/cheatsheets/</code> instead. Creating the folder by hand (from Obsidian or nvim) works the same as <code>hugo new</code>.</p> <h2 id="front-matter">Front matter <a class="anchor" href="#front-matter" aria-label="Link to this section">#</a></h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;My post&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">date</span><span class="p">:</span><span class="w"> </span><span class="ld">2026-10-21</span><span class="w"> </span><span class="c"># recommended: without it, the last commit that changed the file is used</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">tags</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">prometheus, slo] </span><span class="w"> </span><span class="c"># optional</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;One line for link previews.&#34;</span><span class="w"> </span><span class="c"># optional</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">draft</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="c"># optional: hides it from the published site</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nt">toc</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w"> </span><span class="c"># optional: hides &#34;On this page&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w"> </span></span></span></code></pre></div><p>Don&rsquo;t repeat the title as a <code># Heading</code> in the body: the page prints it already. Sections start at <code>##</code>.</p>