Skip to content

示例库

本页截图与代码均来自随插件发布的演示库,可直接打开对照。

下载中文演示库

浮动与绕排 ​

宽度低于阈值的单图会靠边浮动,正文进入剩余空间;浮动持续到下一个结构边界。

文字绕排 ​

图片浮在右侧,正文绕到左侧空白区
markdown
![山道|ag:layout=float|ag:side=right|ag:width=37%](assets/photo/04-road.jpg)

图片浮到右侧后,正文填入左侧剩余空间。绕排仅在阅读视图中生效:实时预览为保持编辑光标稳定,不会让文字绕到图片旁边,只按相同宽度为图片预留位置。因此同一篇笔记在两个视图中的段落高度不同。

浮动在哪里终止 ​

浮动的生命周期终止于下一个结构边界。默认以下六类结构均会终止浮动:

边界默认关闭后的风险
标题开下一节仍紧贴图片排版,标题可能被压缩
代码块开代码块与图片并排,行宽不足时换行
数学块开公式被压缩
图片开两张图片并排,等同于画廊
表格开表格宽度不足,列被压缩
引用 / 标注开引用块紧贴图片边缘

以上各项均可在设置页“浮动截止”中单独关闭。关闭后浮动会跨过该类结构,但两块内容可能并排挤压,通常不符合预期。

不浮动的条件 ​

两个条件必须同时满足:计算宽度不超过 floatMax(默认 60%),且当前栏宽大于 mobileBreakpoint(默认 600px)。任一条件不满足时,图片退回居中块。

也可强制指定:

写法结果
ag:layout=center退出浮动,使用居中块
ag:side=center同上
ag:layout=float即使宽度超过阈值也浮动(需谨慎使用)
ag:side=left / right指定浮动方向

间距 ​

ag:gap=24px 仅增加浮动图与正文之间的空隙,不影响画廊格子间距;后者由设置页的“画廊图片间距”控制。

该差异属于常见误解,参见容易误解的行为。

下一步 ​

相关阅读 ​