<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Markdown on 汉德君的博客</title><link>https://www.handejun.com/tags/markdown/</link><description>Recent content in Markdown on 汉德君的博客</description><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Sun, 08 Nov 2026 09:20:00 +0800</lastBuildDate><atom:link href="https://www.handejun.com/tags/markdown/index.xml" rel="self" type="application/rss+xml"/><item><title>写作指南：Markdown 排版速查</title><link>https://www.handejun.com/posts/markdown-guide/</link><pubDate>Sun, 08 Nov 2026 09:20:00 +0800</pubDate><guid>https://www.handejun.com/posts/markdown-guide/</guid><description>本站支持的 Markdown 语法与排版效果速查，写新文章时可以对照这份示例。</description><content:encoded><![CDATA[<p>这篇文章既是写作说明，也是排版样式的预览。需要时可以直接复制格式。</p>
<h2 id="标题层级">标题层级</h2>
<p>文章内标题从 <code>##</code> 开始，右侧会自动生成锚点，正文上方会显示目录。</p>
<h3 id="三级标题">三级标题</h3>
<h4 id="四级标题">四级标题</h4>
<h2 id="强调与链接">强调与链接</h2>
<p><strong>加粗</strong>、<em>斜体</em>、<del>删除线</del>、<code>行内代码</code>，以及<a href="https://gohugo.io/">一个链接</a>。</p>
<h2 id="列表">列表</h2>
<p>无序列表：</p>
<ul>
<li>第一项</li>
<li>第二项
<ul>
<li>嵌套项</li>
<li>另一个嵌套项</li>
</ul>
</li>
<li>第三项</li>
</ul>
<p>有序列表：</p>
<ol>
<li>先做这件事</li>
<li>再做那件事</li>
<li>最后收尾</li>
</ol>
<p>任务列表：</p>
<ul>
<li><input checked="" disabled="" type="checkbox"> 搭建站点</li>
<li><input checked="" disabled="" type="checkbox"> 写第一篇文章</li>
<li><input disabled="" type="checkbox"> 绑定自定义域名</li>
</ul>
<h2 id="引用">引用</h2>
<blockquote>
<p>好的文字，是把复杂的事情说简单，而不是把简单的事情说复杂。</p>
<p>—— 某位记不清名字的作者</p>
</blockquote>
<h2 id="代码">代码</h2>
<p>行内代码写作 <code>`const a = 1`</code>。</p>
<p>代码块支持语法高亮与右上角复制按钮：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript"><span class="line"><span class="cl"><span class="kr">export</span> <span class="kr">async</span> <span class="kd">function</span> <span class="nx">getPosts</span><span class="p">(</span><span class="nx">tag</span><span class="p">)</span> <span class="p">{</span>
</span></span><span class="line"><span class="cl">  <span class="kr">const</span> <span class="nx">res</span> <span class="o">=</span> <span class="kr">await</span> <span class="nx">fetch</span><span class="p">(</span><span class="sb">`/index.json`</span><span class="p">);</span>
</span></span><span class="line"><span class="cl">  <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">res</span><span class="p">.</span><span class="nx">ok</span><span class="p">)</span> <span class="k">throw</span> <span class="k">new</span> <span class="nb">Error</span><span class="p">(</span><span class="s2">&#34;加载失败&#34;</span><span class="p">);</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">  <span class="kr">const</span> <span class="nx">posts</span> <span class="o">=</span> <span class="kr">await</span> <span class="nx">res</span><span class="p">.</span><span class="nx">json</span><span class="p">();</span>
</span></span><span class="line"><span class="cl">  <span class="k">return</span> <span class="nx">posts</span><span class="p">.</span><span class="nx">filter</span><span class="p">((</span><span class="nx">p</span><span class="p">)</span> <span class="p">=&gt;</span> <span class="nx">p</span><span class="p">.</span><span class="nx">title</span><span class="p">.</span><span class="nx">includes</span><span class="p">(</span><span class="nx">tag</span><span class="p">));</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span>
</span></span></code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new content posts/new-post.md
</span></span><span class="line"><span class="cl">hugo server -D
</span></span></code></pre></div><h2 id="表格">表格</h2>
<table>
	<thead>
			<tr>
					<th>语法</th>
					<th>作用</th>
					<th>示例</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>**文本**</code></td>
					<td>加粗</td>
					<td><strong>重点</strong></td>
			</tr>
			<tr>
					<td><code>*文本*</code></td>
					<td>斜体</td>
					<td><em>提示</em></td>
			</tr>
			<tr>
					<td><code>`代码`</code></td>
					<td>行内代码</td>
					<td><code>hugo</code></td>
			</tr>
			<tr>
					<td><code>[文字](链接)</code></td>
					<td>超链接</td>
					<td><a href="https://gohugo.io/">官网</a></td>
			</tr>
	</tbody>
</table>
<h2 id="图片">图片</h2>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl">![<span class="nt">图片说明</span>](<span class="na">/images/example.png &#34;可选标题&#34;</span>)
</span></span></code></pre></div><p>图片建议放在 <code>static/images/</code> 目录下，引用时以 <code>/images/</code> 开头，构建时会原样复制。</p>
<h2 id="分隔线">分隔线</h2>
<hr>
<h2 id="小提示">小提示</h2>
<ul>
<li>每篇文章的 <code>summary</code> 会显示在列表页，写一两句话概括即可；</li>
<li>太长的文章记得多用二级标题，方便生成目录；</li>
<li>草稿保持 <code>draft: true</code>，加 <code>-D</code> 本地预览时才会出现。</li>
</ul>
]]></content:encoded></item></channel></rss>