🎉開站第一篇! Hero Markdown 寫作
Hero 文章的 Markdown 寫法，以及提示框、引用與程式碼等特殊格式。
這篇是 Hero 的 Markdown 筆記。
文章內容使用一般 Markdown
特殊區塊則沿用 Hero／Hexo 常見的 tag 語法。
1. Frontmatter
每篇文章開頭使用 YAML frontmatter，放在兩段 --- 之間：
---
title: 文章標題
publishedAt: 2026-09-13
description: 顯示在文章列表的摘要。
cover:
key: https://cdn.jsdelivr.net/gh/RynoLiu/RyNotes-assets@20260913_r4/notes/hero-markdown-tutorial/cover.jpg
alt: 文章封面替代文字
tags: [markdown, notes]
categories: [技術]
---
必要欄位是 title 與 publishedAt。公開文章的圖片放在 RynoLiu/RyNotes-assets
2. 標題與基本文字
文章標題由 title 產生，因此正文通常從 ## 開始，依序使用 ###、#### 建立層級。
一般段落可以使用 粗體、斜體、行內程式碼，也可以加入外部連結。
3. 清單、引用與分隔線
無序清單：
- 先寫清楚文章目的
- 再補充必要背景
- 最後留下可執行的結論
有序清單：
- 開啟文章檔案
- 編輯 frontmatter
- 執行
npm run check
Table：
| A | B | C | |
|---|---|---|---|
| 1 | a | b | c |
| 2 | d | e | f |
| 3 | g | h | i |
需要分隔段落時，可以使用：
4. 程式碼區塊
使用三個反引號包住程式碼，並在第一行標示語言：
const title = "Hero Markdown";
console.log(title);
語言名稱會用於語法高亮，例如 ts、js、css、html 或 yaml。
5. 提示框（note）
提示框使用 Hexo tag 語法。第一個參數是類型，第二個參數是可選標題：
使用時機
提示框適合放補充說明，不要把主要段落全部放進提示框。
支援的類型包括 default、primary、info、success、warning、danger。不需要標題時可以省略：
正式文章不要把 private 圖片 URL 貼到公開內容。
6. 引用區塊（blockquote）
需要顯示作者或來源時，可以使用：
這是一段需要特別標示的引用內容。
RyNotes
如果只需要一般引用，使用原生 Markdown > 就足夠。
7. 命名程式碼區塊（codeblock）
需要顯示區塊標題時，使用 codeblock：
const message = "hello";lang: 用來指定語言，標題則放在後面；不需要標題時可以省略。
8. 圖片與影音
公開圖片使用固定版本的 jsDelivr URL：
圖片檔案命名與放置位置請遵守 docs/post-media.md。private 文章則只能使用文章資料夾內的相對路徑。
影音可使用 YouTube 或 Vimeo tag：
{% youtube VIDEO_ID %}
{% vimeo VIDEO_ID %}
