Markdown 语法 · 图片

Markdown 图片尺寸怎么设？
图太大怎么缩小

你有一张 Markdown 图片,渲染正常但出来特别大,想把它缩小。诚实的起点:标准 Markdown 没有设置图片尺寸的办法。![alt](路径) 语法不带宽度,所以没有纯 Markdown 的选项。

所以你走两条路之一:加一点 HTML(几乎哪都能用),或用你的编辑器支持的简写。下面讲每种怎么做。

本页讲的是图太大。如果你的图是空白或坏的,那是路径问题,看 怎么插入图片、以及为什么不显示。

可移植的办法：HTML img 标签

多数 Markdown 渲染器允许行内 HTML,所以设宽度最稳的跨工具办法,就是把图片写成 HTML 的 <img> 标签、而不是 Markdown,给它一个 width:

<img src="images/pic.png" alt="示意图" width="300">

这在 GitHub、多数静态站点生成器、多数编辑器里都会把图片渲染成 300 像素宽。唯一要注意的:少数严格或做了净化的渲染器会剥掉原始 HTML,那样标签就不生效。当你需要一种"哪都一样"的办法,就是它。

在 NoteLoom 里：宽度简写，或直接拖

如果你在 NoteLoom 里写,有两个更快的选择,而且都留在 Markdown 图片本身里。

给 alt 加宽度简写。给 alt 文字加 |300(像素)或 |50%(图片自然尺寸的百分比):

![示意图|300](images/pic.png)     宽 300 像素
![示意图|50%](images/pic.png)     原图自然尺寸的 50%

或者拖拽改大小。在编辑器里,标准行内图片右下角有个小把手。拖它改宽度,NoteLoom 会把新宽度写回文件,不用打数字。

关于简写有一句诚实的话:|300 这种写法是 NoteLoom 支持的便捷功能,不是标准 Markdown。不认它的工具只会把 |300 当字面文本显示在 alt 里。所以如果文件要在很多不同工具里读,优先用上面的 HTML <img>;如果你就在 NoteLoom 里工作,简写和拖拽把手更快。

该用哪个？

办法 怎么做 什么时候
可移植 HTML 一个带 width 的 <img> 标签 GitHub 和多数渲染器都认；最稳的跨工具选择
NoteLoom 简写 给 alt 加 |300 或 |50% 快，但非标准 Markdown，别处可能显示成字面文本
NoteLoom 拖拽 拖图片的改宽把手 不用打字；宽度写回文件

一句话:文件要在工具之间搬,用 HTML <img>;你就在 NoteLoom 里、只想把图现在缩小,|300 简写或拖拽把手一秒搞定。

在 NoteLoom 里试

NoteLoom 是个在浏览器里读写本地 .md 文件的编辑器。它在 live 和 reading 视图里渲染你的图片,所以你可以给 alt 加个 |300、或拖角上的把手,当场看着图片缩放,然后存回本地。

先说清边界:NoteLoom 没有任何 AI。它不生成、不抓取、也不编辑图片本身;它渲染你的 Markdown、存回文件。宽度设多少,由你自己定。

用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载放着笔记和图片的本地文件夹,在 source 视图里设宽度或拖拽。直接存回本地,不上云、不用账号。

相关阅读

Markdown 不渲染？常见的坑 诊断枢纽：渲染器问题 vs 语法坑，每个症状对应修法。 Markdown 怎么插入图片？ 另一种情况：插入图片，以及为什么它有时根本不显示。 Markdown 怎么写？ 基础语法，含图片。 Markdown 分隔线怎么画？ 另一个语法问题，以及 --- 变标题的坑。 md 文件怎么打开？ 把文字放进渲染器，图片才真的显示。 网页版 Markdown 编辑器 浏览器里边写边看本地 md 文件。

FAQ

Markdown 能设置图片尺寸吗？
标准 Markdown 不能。![alt](路径) 语法不带宽度或高度选项。要设尺寸，要么退回到行内 HTML 的 img 标签，要么用你所在编辑器支持的宽度简写（如果它支持的话）。
Markdown 图太大怎么缩小？
给它一个宽度。可移植的办法是 HTML img 标签：一个带 src 和 width="300" 的 img。GitHub 和多数渲染器都认。在支持的编辑器里（比如 NoteLoom），你也可以给 alt 加 |300，或直接拖拽改大小。
![alt|300](路径) 到处都好使吗？
不。那个 |宽度 简写是一些 Markdown 编辑器（包括 NoteLoom）提供的便捷功能，但它不是标准 Markdown。不认它的工具会把 |300 当成字面文本、原样显示在 alt 里。想要到处渲染一致，用 HTML img 标签。
NoteLoom 里的百分比（|50%）是什么意思？
在 NoteLoom 里，![alt|50%](pic.png) 把图片设成它自己自然尺寸的 50%，而不是页面宽度的 50%。因为是按自然尺寸算的，所以编辑和阅读视图里看到的大小一致。
能拖拽改大小、而不是打一个数字吗？
在 NoteLoom 编辑器里能。标准行内图片右下角有个小把手，拖它改宽度，NoteLoom 会把新宽度写回文件。不用打数字。
我的图不是太大、是根本不显示，是一回事吗？
不，那是另一个问题。设尺寸针对的是"图能渲染但太大"。如果你的图空白或坏了，通常是路径或读不到本地文件的问题，看插入图片和为什么不显示那篇。

改个图片大小、当场看结果

用 Chrome / Edge / Arc 打开 NoteLoom,挂载一个本地文件夹,给 alt 打个 |300 或拖它的把手来设宽度、看 live 视图里的结果。直接存回本地,不用装软件,也不用注册账号。

打开 NoteLoom 试试