我的第一篇部落格文章:撰寫指南與 Markdown 簡介
歡迎來到我的部落格!
這是我使用 Jekyll 和 Hydure 主題搭建的第一篇測試文章。我會在這裡分享一些關於如何撰寫部落格文章的簡單指南,並介紹基本的 Markdown 語法。
如何撰寫新的部落格文章?
要寫一篇新的文章非常簡單,請遵循以下步驟:
-
創建檔案: 在您的部落格專案資料夾中,找到
_posts
資料夾。 在這個資料夾裡,創建一個新的 Markdown 檔案(副檔名為.md
或.markdown
)。 - 命名規則:
檔案名稱必須遵循特定的格式:
YYYY-MM-DD-您的文章標題.md
。YYYY-MM-DD
:文章發布的日期,例如2025-06-13
。您的文章標題
:用連字號-
連接的英文標題,例如my-first-blog-post
。 所以,完整檔案名看起來會像這樣:2025-06-13-my-first-blog-post.md
。
- 添加 YAML Front Matter:
每篇文章的最上方,必須有一個由三個連字號
---
包裹的區塊,稱為 YAML Front Matter。這個區塊用來定義文章的元數據(metadata)。 例如:--- layout: post title: 文章的標題 date: YYYY-MM-DD HH:MM:SS +時區偏移 categories: [分類一, 分類二] tags: [標籤一, 標籤二] description: 文章的簡短描述,用於預覽或 SEO。 mathjax: false # 如果需要公式顯示,改為 true comments: true # 如果需要評論,改為 true ---
請確保
layout: post
是正確的,這會告訴 Jekyll 使用post
佈局來渲染您的文章。 - 開始撰寫內容: 在 YAML Front Matter 之後,您就可以使用 Markdown 語法自由地撰寫您的文章內容了。
Markdown 基本語法快速說明
Markdown 是一種輕量級標記語言,讓您可以輕鬆地撰寫格式化的文本。
標題 (Headings)
使用 #
符號來創建不同級別的標題。#
的數量代表標題的級別。
```markdown