https://docusnotes.pages.dev/tags/yaml/Recent content in YAML on DocusNoteshttps://docusnotes.pages.dev/images/default-cover.pnghttps://docusnotes.pages.dev/images/default-cover.pngHugozh-twMon, 01 Jan 0001 00:00:00 +0000https://docusnotes.pages.dev/posts/yaml-syntax/Sat, 05 Sep 2026 00:00:00 +0000https://docusnotes.pages.dev/posts/yaml-syntax/<p>YAML的設計核心是「人類可讀性高」，它的結構完全依賴縮排和特定的符號來決定。</p> <h2 id="核心規則">核心規則</h2> <p>YAML三個禁忌：</p> <ol> <li> <p>只能使用「空格」縮排<br> 絕對<strong>不能使用Tab鍵</strong>。如果使用Tab鍵，編譯時網站一定會報錯。通常建議固定使用2個空格作為一層縮排。</p> </li> <li> <p>冒號後面一定要有空格<br> 寫設定時，冒號後面必須加上一個空格（ <code>例如title: 我的文章</code> ），只寫 <code>title:我的文章</code> 是錯誤的。</p> </li> <li> <p>大小寫敏感<br> <code>Title</code> 、 <code>TITLE</code> 和 <code>title</code> 在YAML裡被視為完全不同的東西。</p> </li> </ol> <h2 id="四大基礎語法與資料型態">四大基礎語法與資料型態</h2> <p>在Markdown的文章開頭（Front Matter），會用到的語法主要有以下四種：</p> <h3 id="基礎鍵值對key-value">基礎鍵值對（Key-Value）</h3> <p>最簡單的設定，用來宣告單一屬性。</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-yaml" data-lang="yaml"><span style="display:flex;"><span><span style="color:#f92672">yamltitle</span>: <span style="color:#ae81ff">我的第一篇文章</span> <span style="color:#75715e"># 字串：通常不需要加引號</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">draft</span>: <span style="color:#66d9ef">false</span> <span style="color:#75715e"># 布林值：必須是小寫的true或false</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">weight</span>: <span style="color:#ae81ff">10</span> <span style="color:#75715e"># 整數</span> </span></span><span style="display:flex;"><span><span style="color:#f92672">price</span>: <span style="color:#ae81ff">99.9</span> <span style="color:#75715e"># 浮點數</span> </span></span></code></pre></div><h3 id="字串與引號string">字串與引號（String）</h3> <p>單引號會將內容視為純字串（Literal String）。裡面的所有字元都不會被轉義（Escape），寫什麼就是什麼。雙引號會解析跳脫字元（Escape Characters），用換行、縮排等特殊字元時用，如寫 <code>text: &quot;第一行\n第二行&quot;</code> 將會換行。定義物件（Key）時，YAML的Key通常不加引號，保持乾淨。布林值、數字、Null亦不加引號。</p> <ul> <li>使用時機對照表 <table> <thead> <tr> <th>情況</th> <th>無引號</th> <th><code>' '</code></th> <th><code>&quot; &quot;</code></th> </tr> </thead> <tbody> <tr> <td>一般純文字 ( <code>hello</code> )</td> <td>建議使用</td> <td>可用</td> <td>可用</td> </tr> <tr> <td>包含特殊符號 ( <code>:</code> , <code>#</code> , <code>[]</code> )</td> <td>不可</td> <td>最安全</td> <td>可用</td> </tr> <tr> <td>強制轉為字串 ( <code>true</code> , <code>123</code> )</td> <td>不可，變布林/數字</td> <td>最安全</td> <td>可用</td> </tr> <tr> <td>需要跳脫字元 ( <code>\n</code> 換行)</td> <td>不可，失效</td> <td>不可，失效</td> <td>可用</td> </tr> </tbody> </table> </li> </ul> <p>範例：</p>