建立和編輯 Obsidian 風格的 Markdown，包含 wikilinks、嵌入、callouts、屬性及其他 Obsidian 專用語法。適用於在 Obsidian 中處理 .md 檔案，或當使用者提及 wikilinks、callouts、frontmatter、標籤、嵌入或 Obsidian 筆記時使用。
Obsidian 風格 Markdown 技能
建立和編輯有效的 Obsidian 風格 Markdown。Obsidian 在 CommonMark 和 GFM 的基礎上擴充了 wikilinks、嵌入、callouts、屬性、註解等語法。本技能僅涵蓋 Obsidian 專屬的擴充功能——標準 Markdown（標題、粗體、斜體、清單、引用、程式碼區塊、表格）視為已知知識。
工作流程：建立一則 Obsidian 筆記
- 加入 frontmatter，在檔案頂端設定屬性（標題、標籤、別名）。所有屬性類型請參閱 PROPERTIES.md。
- 撰寫內容，使用標準 Markdown 建立結構，並搭配下方 Obsidian 專用語法。
- 連結相關筆記，使用 wikilinks（
[[Note]]）進行內部筆記庫連結，外部 URL 則使用標準 Markdown 連結。 - 嵌入內容，從其他筆記、圖片或 PDF 嵌入內容，使用
![[embed]]語法。所有嵌入類型請參閱 EMBEDS.md。 - 加入 callouts，使用
> [!type]語法標示重點資訊。所有 callout 類型請參閱 CALLOUTS.md。 - 驗證筆記在 Obsidian 閱讀檢視中正確呈現。
在 wikilinks 和 Markdown 連結之間選擇時：筆記庫內的筆記請使用
[[wikilinks]]（Obsidian 會自動追蹤重新命名），外部 URL 才使用[text](url)。
內部連結（Wikilinks）
[[Note Name]] 連結到筆記
[[Note Name|Display Text]] 自訂顯示文字
[[Note Name#Heading]] 連結到標題
[[Note Name#^block-id]] 連結到區塊
[[#Heading in same note]] 同一筆記內的標題連結
在任何段落後加上 ^block-id 即可定義區塊 ID：
這個段落可以被連結。 ^my-block-id
對於清單和引用，請將區塊 ID 放在區塊後面的獨立一行：
> 一個引用區塊
^quote-id
嵌入
在任何 wikilink 前面加上 ! 即可內嵌其內容：
![[Note Name]] 嵌入完整筆記
![[Note Name#Heading]] 嵌入章節
![[image.png]] 嵌入圖片
![[image.png|300]] 嵌入圖片並設定寬度
![[document.pdf#page=3]] 嵌入 PDF 頁面
音訊、影片、搜尋嵌入及外部圖片請參閱 EMBEDS.md。
Callouts
> [!note]
> 基本 callout。
> [!warning] 自訂標題
> 帶有自訂標題的 callout。
> [!faq]- 預設摺疊
> 可摺疊的 callout（- 摺疊，+ 展開）。
常見類型：note、tip、warning、info、example、quote、bug、danger、success、failure、question、abstract、todo。
完整清單（含別名、巢狀及自訂 CSS callouts）請參閱 CALLOUTS.md。
屬性（Frontmatter）
---
title: 我的筆記
date: 2024-01-15
tags:
- project
- active
aliases:
- 替代名稱
cssclasses:
- custom-class
---
預設屬性：tags（可搜尋的標籤）、aliases（連結建議用的替代筆記名稱）、cssclasses（用於樣式的 CSS 類別）。
所有屬性類型、標籤語法規則及進階用法請參閱 PROPERTIES.md。
標籤
#tag 行內標籤
#nested/tag 巢狀標籤（有層級）
標籤可包含字母、數字（不能是第一個字元）、底線、連字號和正斜線。標籤也可以在 frontmatter 的 tags 屬性中定義。
註解
這是可見的文字 %%但這是隱藏的%% 文字。
%%
整個區塊在閱讀檢視中隱藏。
%%
Obsidian 專用格式
==反白文字== 反白語法
數學（LaTeX）
行內：$e^{i\pi} + 1 = 0$
區塊：
$$
\frac{a}{b} = c
$$
圖表（Mermaid）
```mermaid
graph TD
A[開始] --> B{決定}
B -->|是| C[執行這個]
B -->|否| D[執行那個]
```
若要將 Mermaid 節點連結到 Obsidian 筆記，請加上 class NodeName internal-link;。
腳註
帶有腳註的文字[^1]。
[^1]: 腳註內容。
行內腳註。^[這是行內腳註。]
完整範例
---
title: 專案 Alpha
date: 2024-01-15
tags:
- project
- active
status: in-progress
---
# 專案 Alpha
本專案旨在使用現代技術來[[改善工作流程]]。
> [!important] 關鍵截止日
> 第一個里程碑將在 ==1 月 30 日== 到期。
## 任務
- [x] 初步規劃
- [ ] 開發階段
- [ ] 後端實作
- [ ] 前端設計
## 備註
該演算法使用 $O(n \log n)$ 排序。詳情請參閱 [[演算法筆記#排序]]。
![[架構圖.png|600]]
已在 [[會議記錄 2024-01-10#決策]] 中審閱。
