引用檔案與媒體

青苔用 wikilink 引用任何東西：[[雙方括號]] 裡寫檔名、標題或媒體名稱。青苔會在整個資料夾中搜尋檔名，你不必寫具體的路徑。

連結

按檔名、標題和網址來比對。常見變體：

寫法作用
[[檔名|連結文字]]自訂顯示文字（豎線後是讀者看到的文字）
[[檔名#段落標題]]連結到某個標題
[[檔名#^intro]]連結到某個段落（區塊引用）

在段落末尾加上 ^intro，就能給它一個穩定的區塊 ID，之後在別處用 [[頁面#^intro]] 引用。

嵌入

在方括號前加 !，就把目標內容內聯到當前頁面，而不只是連結：

寫法嵌入內容
![[檔名]]整個檔案
![[檔名#章節名]]檔案的某個章節
![[檔名#^intro]]檔案的某個段落
`<!--MOSS_MARKER_FOLDER_LIST:path=資料夾/from=zh-hant/開始使用/引用檔案與媒體.md-->`

路徑以 / 結尾表示資料夾。資料夾嵌入可帶參數，比如 <!--MOSS_MARKER_FOLDER_LIST:path=相簿/|from=zh-hant/開始使用/引用檔案與媒體.md|limit=5--> 只顯示最新 5 項並追加「更多 →」連結。

媒體

圖片、影片等檔案放進資料夾，用 wikilink 或標準 markdown 引用即可，青苔會自動解析檔案名稱、最佳化媒體檔案。

![[sunset.jpg]]
![日落時的海岸](photos/sunset.jpg)
![[sunset.jpg|日落時的海岸]]

後兩種寫法中，「日落時的海岸」會成為圖片下方的圖說，同時供螢幕閱讀器和搜尋引擎使用。

支援的媒體類型：

把媒體放進被排除的資源資料夾（assets/、images/、static/、public/），它們會對外提供但不作為頁面。

控制顯示

在檔名後用豎線追加參數，控制圖片的尺寸、填充與定位：

![[cover.jpg|400]]           # 寬 400px
![[cover.jpg|100%]]          # 寬 100%
![[cover.jpg|200x150]]       # 寬 × 高
![[headshot.jpg|cover top]]  # 填充方式 + 定位

尺寸：寫寬度或「寬×高」，單位支援 px（預設）、%、vh，如 400、100%、200x150。

填充方式（對應 CSS object-fit）：cover（預設，填滿並裁切）、contain（完整展示）、fill、none、scale-down。定位：center、top、left、bottom-right 等。

一條豎線只表達一種意思——尺寸、填充定位、或圖說，三者不在同一條豎線裡混用。

深入了解

解析優先序、循環嵌入處理、封面圖、children_source 等細節，見英文文件 Links & Embeds 與 Media。

青苔發佈