裁剪与取景
ag:crop决定画幅比例，ag:top决定画框在原图中的位置；如不便手算坐标，可使用裁剪对话框。
未裁剪
markdown
原图比例为 16:9，完整显示。
裁成方形
markdown
ag:crop=1:1 将画幅改为正方形；ag:top=25:75:2 取横向 25%–75%、纵向从 2% 开始的区域。纵向仅写一个数值，因为高度已由比例确定。
取任意局部
markdown
第一张取左上角区域，第二张取右侧偏上的方形区域。参数越界时，插件会自动夹紧至画面范围内；左右端点顺序颠倒时也会自动交换，不会产生空白图像。
裁剪对话框
如需避免手算坐标，可悬停图片并点击剪刀图标。对话框仅写入 ag:crop 与 ag:top 两个参数。
| 操作 | 效果 |
|---|---|
| 拖动某条边 | 仅移动该边，其余三边不动 |
| 拖动角点 | 同时移动相邻两条边 |
Shift + 拖动 | 锁定当前比例 |
Alt + 拖动 | 以中心为对称点缩放 |
| 滚轮 | 放大编辑视图（1–4×），不改变裁剪结果 |
| 比例下拉 | 自由 / 当前比例 / 1:1 / 4:3 / 3:2 / 16:9 / 9:16 / 3:4 / 2:3 |
| 保存 | 写入 ag:crop 与 ag:top |
| 清除裁剪 | 移除两个参数，恢复完整画面 |
| 重置取景 | 将画框恢复为全图，不关闭对话框 |
两项行为约定：
- “当前比例”仅在没有锁定预设时出现；下次打开时沿用上次选择的比例。
- 画框覆盖全图时，保存不会写入任何参数，以避免将“未裁剪”记录为“裁剪后等于原图”，导致比例被固定。
存在未保存改动时，点击空白处、按 Esc 或点击取消，均会提示“放弃修改”。
对话框在实时预览中打开，阅读视图没有入口。
裁剪会改变宽度路由
裁成方形后，插件使用裁剪后的比例，而非原图比例：一张 16:9 宽图裁成 1:1 后，会自动从接近满栏收窄至约一半，并重新判断是否浮动。
因此，裁剪不仅改变画面内容，也会改变图片在页面中的位置；该行为属于预期结果。
若裁剪框会使图片底边超出原图，插件会选择放宽画框，而不是裁掉内容；优先保留更多画面，而非裁掉用户需要的边缘。
两个限制
| 限制 | 说明 |
|---|---|
ag:top 依赖 ag:crop | 未写入 crop 时，重写参数会丢弃 top |
| 表格中仅支持裁剪 | 表格单元格不支持宽度与浮动，参见嵌套作用域 |