當使用者要求撰寫 HackMD 筆記、技術文件、投影片(Slide Mode),或詢問 HackMD 特有的 Markdown 語法(色塊、螢光筆、數學公式、Mermaid、Markmap、reveal.js 投影片等)時啟動此 Skill。
撰寫與排版 HackMD 文件、技術筆記及 Reveal.js 投影片的完整指南。
依任務類型決定需要載入哪些 reference 檔案:
使用者要寫一般筆記 / 技術文件?
→ 載入 references/syntax-basics.md(基本語法)
→ 若用到圖表、數學、嵌入 → 另載入 references/advanced-features.md
使用者要製作投影片(Slide Mode)?
→ 載入 references/syntax-basics.md(基本語法)
→ 載入 references/advanced-features.md(圖表 / 公式)
→ 必載 references/slide-mode.md(投影片專屬設定)
使用者只問語法問題?
→ 先查下方《常用語法速查》,能回答就直接回答,不必載入 reference
以下為最高頻使用的 HackMD 語法,熟悉後多數問題不需讀 reference:
| 功能 | 語法 |
|---|---|
| 標題 | # H1 … ###### H6 |
| 粗體 / 斜體 | **粗體**、*斜體*、***粗斜體*** |
| 刪除線 |
~~刪除~~| 螢光筆 | ==重點== |
| 上標 / 下標 | 19^th^、H~2~O |
| 行內程式碼 | `code` |
| TOC | [TOC](置於文件任意處) |
| 色塊(info) | :::info … ::: |
| 行內數學 | $x^2 + y^2$ |
| 區塊數學 | $$ … $$ |
| Mermaid 圖 | ```mermaid … ``` |
| YouTube 嵌入 | {%youtube VIDEO_ID %} |
| 投影片分頁 | ---(水平)/----(垂直),上下各空一行 |
:::success ← 綠色
:::info ← 藍色
:::warning ← 黃色
:::danger ← 紅色
:::spoiler ← 收合區塊(需加標題文字)
產出 HackMD 內容前,確認以下事項:
:::type 語法,不用 <div> 代替$...$,左 $ 後與右 $ 前不能有空格[TOC](而非只靠右下角按鈕)==text== 不能跨行;跨行需改用 HTML <mark>slideOptions.theme 與 slideOptions.transition 已設定{%youtube id%} 或 {%hackmd id%},不硬貼 iframe| 檔案 | 用途 | 何時載入 |
|---|---|---|
references/syntax-basics.md | 基本文字、清單、表格、連結、圖片、TOC | 撰寫一般筆記 |
references/advanced-features.md | 色塊、數學公式、UML / Mermaid / Markmap、外嵌 | 文件含圖表 / 公式 / 嵌入 |
references/slide-mode.md | 投影片分頁、YAML 選項、動畫、主講者模式 | 製作 Slide Mode 簡報 |