应先复制哪种格式？
先用直链确认能打开，再按目标平台选择 Markdown、HTML 或 BBCode。
嵌入格式
在 Markdown、HTML 和 BBCode 中使用图片链接
对比同一张图的直链、Markdown、HTML 与 BBCode，并排查嵌入不显示的问题。
直链Markdown / HTML / BBCode同一演示图
根据目标平台选择格式
大多数嵌入问题，都是把能用的链接粘成了错误的语法。先从图片要出现的位置出发：那里的编辑器接受什么格式？需要直接显示图片，还是只放一个链接？
- 聊天软件、邮件和工单：粘贴图片直链。很多平台会自动显示预览，即使预览被拦截，链接本身也仍然可用。
- GitHub、GitLab、文档站和笔记软件：使用 Markdown，并把默认的替代文本改成对图片内容的简短描述，例如“设置页面，保存按钮已高亮”。
- CMS 编辑器和手写网页：需要控制尺寸时使用 HTML。给 img 标签加上 width="600"，大截图就不会把版面撑开。
- 使用 phpBB、vBulletin、MyBB 等程序的论坛：使用 BBCode。有些论坛只允许来自白名单图床的图片；如果 [img] 标签显示为空白框，就改为把直链作为普通链接发布。
同一演示图，四种输出
以下示例使用站方维护的演示资源，便于对比格式，而不依赖即将到期的用户上传。
实际预览
若预览可加载，说明直链在普通浏览器标签页可用。
https://assets.mini-tools.uk/image/icon-512x512.png
直链
粘贴到聊天、工单或需要图片 URL 的工具。
https://assets.mini-tools.uk/image/icon-512x512.pngMarkdown
用于 GitHub README、文档和 Markdown 编辑器。
HTML
仅在编辑器接受 img 标签时使用。
<img src="https://assets.mini-tools.uk/image/icon-512x512.png" alt="Mini Tools demo">BBCode
仅适用于支持经典 [img] 标签的论坛。
[img]https://assets.mini-tools.uk/image/icon-512x512.png[/img]若要为自己的文件生成格式，请到 /upload 上传。网页会在浏览器中根据返回的直链拼接 Markdown、HTML 和 BBCode。
不要把临时图片链接当作长期 README 中的永久资源。长期使用需在 /upload 使用获批的永久存储。
能点击的链接，不等于嵌入的图片
下面两个示例使用同一条可用图片直链。在 Markdown 中，一个感叹号就能把普通链接变成图片。浏览器示例展示对应的链接和图片元素；论坛或文档编辑器中的实际渲染仍由目标平台决定。
普通链接：读者点击后打开图片
[Mini Tools demo](https://assets.mini-tools.uk/image/icon-512x512.png)文字可以点击，但图片不会直接显示在正文里。截图不是必读内容，或目标平台禁止嵌入图片时，可以使用这种方式。
嵌入图片：读者在正文中看到图片
目标平台支持 Markdown 图片时，图片会直接显示。HTML 编辑器使用上面的 img 元素；BBCode 编辑器则使用 [img] 标签。
根据实际显示结果定位问题
- 整段代码原样显示成文字
- 先确认你看到的是源码编辑区还是渲染预览。放在代码块里的 Markdown 会保持原样；想显示图片时，去掉外层代码围栏，或使用编辑器的“插入图片”功能，只填图片直链。
- 只显示可点击的文字，没有图片
- Markdown 要检查方括号前是否有 !。HTML 的 a 元素用于创建链接，img 元素才显示图片；BBCode 中的 [url] 和 [img] 也不是同一种用途。
- 直链单独能打开，目标平台却不显示
- 浏览器已能访问这条 URL，下一步应检查目标平台的远程图片设置和允许的域名。重复上传同一文件，无法解决编辑器过滤图片标签或屏蔽该域名的问题。
如果图片不显示
- 直链失败：先确认直链单独在新标签页能打开。
- 格式错误：确认目标平台接受你粘贴的格式（Markdown / HTML / BBCode）。
- 临时上传已过期：若使用了临时保留，检查保留期是否已结束。
- 目标站拦截远程图片：有些站点会通过防盗链、CSP 或审核过滤去掉远程图片。
FAQ
API 会返回 Markdown/HTML/BBCode 吗？
不会。API 返回 success、url 等字段；网页上传页在浏览器中根据 URL 生成分享格式。
为什么 Markdown 可以但 HTML 不行？
目标平台可能允许 Markdown 图片语法，但拦截原始 HTML 标签。
可以一直用这个演示 URL 吗？
它是站方用于格式对比的资源。你自己的内容请到 /upload 上传。
Markdown 和 HTML 输出里的替代文本需要修改吗？
需要。默认替代文本比较笼统。简短描述图片内容，可以帮助使用读屏软件的用户，图片加载失败时也会显示这段文字。
相关工具
创建你自己的链接，或阅读其他专项指南。