https://yore.zsl0621.cc/zh-cn/tags/markdown/Recent content in markdown on YoreHugozh-cnTue, 20 Jan 2026 11:30:00 +0800https://yore.zsl0621.cc/zh-cn/%E6%96%87%E6%A1%A3/advanced/markdown-and-hugo/Tue, 20 Jan 2026 11:30:00 +0800https://yore.zsl0621.cc/zh-cn/%E6%96%87%E6%A1%A3/advanced/markdown-and-hugo/<h2 id="semantic-markdown"> Semantic Markdown <a class="heading-anchor" href="#semantic-markdown" aria-label="Permalink to 'Semantic Markdown'"></a> </h2><p>In static site generation, Markdown is not merely a shorthand for text; it is a direct instruction for generating HTML. Hugo follows the <strong>CommonMark</strong> specification via the Goldmark engine. Understanding the underlying HTML output is essential for precise layout control.</p>https://yore.zsl0621.cc/zh-cn/shortcodes/writing/Sat, 17 Jan 2026 10:40:00 +0800https://yore.zsl0621.cc/zh-cn/shortcodes/writing/<h2 id="admonition"> Admonition <a class="heading-anchor" href="#admonition" aria-label="Permalink to 'Admonition'"></a> </h2><p>Admonitions allow you to insert eye-catching callout boxes in your content.</p> <p><strong>Example: Markdown syntax with custom icon</strong></p> <div class="highlight-wrapper"><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-md" data-lang="md"><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">[!TIP]+ Custom Title </span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">This is a collapsible tip with a custom icon. </span></span></span><span class="line"><span class="cl">{icon=&#34;twitter&#34;}</span></span></code></pre></div></div> <details class="admonition group relative my-6 overflow-hidden rounded-md shadow dark:shadow-[0_2px_6px_rgba(255,255,255,0.08)] group" data-type="tip" open> <summary class="flex items-center gap-2 px-4 py-2 font-bold admonition-header cursor-pointer"> <div class="flex h-5 w-5 shrink-0 items-center justify-center text-lg"><span class="icon relative block"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"/></svg> </span></div> <div class="grow"> Custom Title </div> <div class="ms-auto flex h-5 w-5 -rotate-90 items-center justify-center transition-transform group-open:rotate-0 print:hidden"><span class="icon relative block"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true" > <path fill-rule="evenodd" d="M5.23 7.21a.75.75 0 011.06.02L10 11.168l3.71-3.938a.75.75 0 111.08 1.04l-4.25 4.5a.75.75 0 01-1.08 0l-4.25-4.5a.75.75 0 01.02-1.06z" clip-rule="evenodd" /> </svg> </span></div> </summary><div class="admonition-content px-4 py-3 text-base leading-relaxed"><p>This is a collapsible tip with a custom icon.</p>