/

Quarkdown

v2.4.0

文档

本页目录

图片尺寸

虽然基础 Markdown 需要借助 HTML 代码来约束图片尺寸，但 Quarkdown 引入了一种语法扩展，能更优雅地实现同样的效果：!(WIDTHxHEIGHT)[ALT](URL)。

示例 1

以下等价的示例像 CommonMark Markdown 那样加载带标签 Alt 的 image.png，同时还添加了一个尺寸约束，将可见图片适配进一个 300px × 100px 的方框中。

!(300x100)[Alt](image.png)

<!-- 或 -->

!(300*100)[Alt](image.png)

<!-- 或 -->

!(300 100)[Alt](image.png)
Icon

除了像素（其单位可以省略）之外，还支持任何其他尺寸 单位。使用其他单位时，必须使用 * 或空格作为分隔符，而不能用 x。

!(5cm*35mm)[Alt](image.png)

<!-- 或 -->

!(2.5in 1cm)[Alt](image.png)

<!-- 但不能这样 -->

!(2.5inx1cm)[Alt](image.png)

<!-- '%' 是个例外。这样写是有效的（虽然可读性不佳） -->

!(30%x150%)[Alt](image.png)

自动维度

当你将任意一个分量（宽度或高度）设置为 _（下划线）时，它就变为自动，即该分量会被计算以保持原始宽高比。

自动高度

<!-- 300px 宽度，自动高度 -->
!(300x_)[Alt](image.png)

<!-- 5cm 宽度，自动高度 -->
!(5cm*_)[Alt](image.png)

<!-- 2in 宽度，自动高度 -->
!(2in _)[Alt](image.png)

<!-- 50% 宽度，自动高度 -->
!(50% _)[Alt](image.png)

作为一种便捷的简写，你可以完全省略自动高度：

<!-- 300px 宽度，自动高度 -->
!(300)[Alt](image.png)

<!-- 5cm 宽度，自动高度 -->
!(5cm)[Alt](image.png)

<!-- 2in 宽度，自动高度 -->
!(2in)[Alt](image.png)

<!-- 50% 宽度，自动高度 -->
!(50%)[Alt](image.png)

自动宽度

<!-- 自动宽度，100px 高度 -->
!(_x100)[Alt](image.png)

<!-- 自动宽度，15mm 高度 -->
!(_*15mm)[Alt](image.png)

<!-- 自动宽度，2in 高度 -->
!(_ 2in)[Alt](image.png)