引用文件与媒体

青苔用 wikilink 引用任何东西：[[双方括号]] 里写文件名、标题或媒体名。青苔在整个文件夹中搜索文件名，你不用写具体的路径。

链接

按文件名、标题和网址来匹配。常见变体：

写法作用
[[文件名|连接文字]]自定义显示文字（竖线后是读者看到的文字）
[[文件名#段落标题]]链接到某个标题
[[文件名#^intro]]链接到某个段落（块引用）

在段落末尾加 ^intro 就能给它一个稳定的块 ID，之后别处用 [[页面#^intro]] 引用。

嵌入

在方括号前加 !，就把目标内容内联到当前页面，而不只是链接：

写法嵌入内容
![[文件名]]整个文件
![[文件名#章节名]文件的某个章节
![[文件名#^intro]]文件的某个段落
`<!--MOSS_MARKER_FOLDER_LIST:path=文件夹/from=zh-hans/开始使用/引用文件与媒体.md-->`

路径以 / 结尾表示文件夹。文件夹嵌入可带参数，比如<!--MOSS_MARKER_FOLDER_LIST:path=相册/|from=zh-hans/开始使用/引用文件与媒体.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。

青苔发布