https://blog.madaoming.com/categories/%E6%95%99%E7%A8%8B/ Recent content in 教程 on Ming 的博客 Hugo -- gohugo.io zh-cn Sat, 15 Aug 2026 00:00:00 +0000 https://blog.madaoming.com/posts/markdown-guide/ Sat, 15 Aug 2026 00:00:00 +0000 https://blog.madaoming.com/posts/markdown-guide/ <p>Markdown 让你专注于内容而不是排版。写博客、写 README、写笔记，一套语法全搞定。</p> <h2 id="常用语法速查">常用语法速查</h2> <table> <thead> <tr> <th>效果</th> <th>语法</th> </tr> </thead> <tbody> <tr> <td>标题</td> <td><code># 一级</code> <code>## 二级</code> <code>### 三级</code></td> </tr> <tr> <td>加粗</td> <td><code>**加粗**</code></td> </tr> <tr> <td>斜体</td> <td><code>*斜体*</code></td> </tr> <tr> <td>链接</td> <td><code>[文字](https://example.com)</code></td> </tr> <tr> <td>行内代码</td> <td><code>`code`</code></td> </tr> <tr> <td>引用</td> <td><code>&gt; 引用内容</code></td> </tr> </tbody> </table> <h2 id="代码块">代码块</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="k">def</span> <span class="nf">hello</span><span class="p">(</span><span class="n">name</span><span class="p">):</span> </span></span><span class="line"><span class="cl"> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&#34;Hello, </span><span class="si">{</span><span class="n">name</span><span class="si">}</span><span class="s2">!&#34;</span><span class="p">)</span> </span></span></code></pre></div><h2 id="列表">列表</h2> <p>无序列表用 <code>-</code>，有序列表用 <code>1. 2. 3.</code>，嵌套缩进即可。</p> <h2 id="排版小技巧">排版小技巧</h2> <ol> <li><strong>每段只表达一个意思</strong>，短段落比长段落更好读</li> <li>列表和表格能大幅提升可读性</li> <li>插入分隔线用 <code>---</code>，注意和标题语法区分</li> <li>中文排版习惯：中英文之间加一个空格，比如 <code>使用 Hugo 写博客</code></li> </ol> <h2 id="进阶">进阶</h2> <ul> <li>图床 / 图片引用</li> <li>数学公式（KaTeX / MathJax）</li> <li>Mermaid 流程图</li> </ul> <p>需要的时候再学，Markdown 的核心就是：<strong>简单到让你忘记格式</strong>。</p>