← 返回數位科技系列 🛠️ 開發工具教學

📝 Markdown 完整語法指南

📅 2026-10-12 · 🏷️ 數位科技 · ⏱️ 約 12 分鐘 · 2026 年最新版，涵蓋基礎語法、Obsidian 特色、Mermaid 圖表、LaTeX 公式與 AI 代理應用

📚 目錄

  1. 標題
  2. 文字樣式
  3. 段落與換行
  4. 引用與 Callout
  5. 列表
  6. 程式碼
  7. 連結
  8. 圖片
  9. 表格
  10. 水平分隔線
  11. 特殊字元跳脫
  12. Mermaid 圖表
  13. LaTeX 數學公式
  14. Obsidian 特有功能
  15. AI 代理與 Markdown 應用
  16. 常見錯誤與最佳實踐
  17. 快速參考卡
  18. 應用情境

1. 標題

# 一級標題    ## 二級    ### 三級    #### 四級    ##### 五級    ###### 六級
💡 每級前後留空行，# 後保留一個空格。

2. 文字樣式

效果語法
粗體**文字**
斜體*文字*
粗斜體***文字***
行內程式碼`程式碼`
刪除線~~文字~~
高亮==文字==（Obsidian 特有）
遮罩||文字||（Telegram 遮罩樣式）

3. 段落與換行

4. 引用與 Callout

> 引用段落
>> 嵌套引用

Obsidian Callout 類型

標籤圖示用途
[!TIP]💡提示建議
[!NOTE]ℹ️補充說明
[!WARNING]⚠️警告
[!IMPORTANT]❗重要資訊
[!CAUTION]🚫謹慎使用
[!SUCCESS]✅成功狀態
[!ERROR]❌錯誤資訊
[!INFO]🔵一般資訊

5. 列表

- 無序項目
  - 嵌套（4 空白縮排）

1. 有序第一步
2. 有序第二步

- [ ] 待辦
- [x] 已完成

同一列表建議用同一符號（-、*、+ 擇一）。

6. 程式碼

行內：pip install

```python
def hello():
    print("Hello, world!")
```
始終標註語言以提升語法高亮。

7. 連結

[文字](https://example.com "標題")
<https://example.com>           <!-- 自動連結 -->
[文字][1]                       <!-- 參考式 -->
[1]: https://example.com "標題"

8. 圖片

![替代文字](https://example.com/img.png "標題")
[![替代文字](img.png)](https://example.com)

Obsidian 內嵌：![[內部檔案.png]]、![[內部檔案.md#章節標題]]

9. 表格

| 欄位一 | 欄位二 | 欄位三 |
|--------|--------|--------|
| 內容 A | 內容 B | 內容 C |

| 左對齊 | 右對齊 | 置中 |
|:-------|-------:|:----:|
| A      |      B |  C   |

10. 水平分隔線

---、***、___ 皆可。

11. 特殊字元跳脫

\ ` * _ { } [ ] ( ) # + - . ! | 前面加 \ 即不解析：

\* 不會變成斜體
\# 不會變成標題

12. Mermaid 圖表

Obsidian 內建支援：

```mermaid
graph TD
    A[開始] --> B{判斷}
    B -->|是| C[執行]
    B -->|否| D[跳過]
    C --> E[結束]
```

支援類型：graph/flowchart 流程圖、sequenceDiagram 序列圖、classDiagram 類別圖、stateDiagram 狀態圖、pie 圓餅圖、gantt 甘特圖、erDiagram ER 圖、journey 用戶旅程圖。

13. LaTeX 數學公式

行內：$E = mc^2$

$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

14. Obsidian 特有功能

功能語法說明
雙鏈結[[筆記標題]]連結其他筆記
反向鏈結編輯模式 Ctrl+Shift+F搜尋反向連結
註解%%隱藏文字%%閱讀模式不顯示
嵌入檔案![[檔案.md]]內嵌其他筆記內容
嵌入標題![[檔案.md#標題]]嵌入特定章節
標籤#標籤分類篩選（勿加空格）

15. AI 代理與 Markdown 應用（2026）

GitHub Copilot 指令檔

<!-- .github/copilot-instructions.md -->
你是一名 Python 開發專家，遵循以下規則：
- 使用 type hints
- 寫單元測試
- 添加文件說明

Prompt 檔案

<!-- .prompt/analyze.prompt.md -->
# 分析指令
請分析以下程式碼：
- 尋找效能瓶頸
- 建議優化方案

Agent Skills 結構

.
├── SKILL.md          ← 技能入口
├── references/       ← 參考資料
├── scripts/          ← 執行腳本
└── templates/        ← 範本

VS Code / VS 2026 Markdown 整合

功能說明
分割/編輯/預覽VS 2026 內建三種模式
Mermaid 渲染Markdown 中直接顯示圖表
Copilot 預覽預覽 Copilot 生成內容
指令提示檔支援 VS Code/VS/JetBrains 跨 IDE
Agent SkillsGitHub Skills 作為資料夾載入

16. 常見錯誤與最佳實踐

❌ 常見錯誤

錯誤正確
#標題（無空格）# 標題
段落內空白縮排空行分隔段落
用 \ 換行行尾雙空白
同一列表混用 -、*、+用同一符號

✅ 最佳實踐

17. 快速參考卡

功能語法
標題# H1 ## H2
粗體 / 斜體**文字** / *文字*
程式碼`程式碼`
連結 / 圖片[文字](URL) / ![alt](URL)
表格 / 分隔線| 欄位 | / ---
引用 / 任務> 文字 / - [ ]
Callout / 註解[!NOTE] 標題 / %%文字%%
雙鏈結[[筆記]]
Mermaid / LaTeX區塊標 mermaid / $公式$
高亮==文字==（Obsidian）

18. 應用情境