尧图网站建设 
Jewel Markdown 图片加载机制全解ImageRendererExtension 与 ImageSourceResolver 的接线指南【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community本文基于 .claude/skills/jewel-markdown/references/IMAGE-LOADING.md 整理编写并结合同目录下的 SKILL.md 等配套文档进行补充说明。需要说明的是当前仓库为该项目的部分模块快照Jewel Markdown 的完整源码platform/jewel/markdown/未包含在本仓库中本文中涉及的所有 API 名称与行为均以技能文档记录为准未做任何外部推断。在 JewelJetBrains 的 Compose 跨平台 UI 工具包中Markdown 渲染是一个「先解析、后渲染」的两阶段管线MarkdownProcessor把原始 Markdown 解析为MarkdownBlock/InlineMarkdown模型再由 Jewel Compose 渲染器把模型变成真正的界面。图片是这个管线中最容易悄悄失效的一环——它不像标题、列表那样由通用块渲染器顺带处理而是依赖两个独立组件协同工作。本文以ImageRendererExtension图片渲染扩展和ImageSourceResolver图片源解析器为主线完整讲解 Jewel Markdown 图片加载的架构、接线方式、带尺寸图片的解析规则、自定义实现方法以及排查图片不显示类问题的常见陷阱。读完本文你将能够独立完成一个可加载本地相对路径与远程图片的 Jewel Markdown 渲染环境并能针对具体故障点精准定位修复。一、先理解架构图片加载由两个独立组件协作完成图片支持需要以下两个组件同时存在它们解决的是完全不同的问题ImageRendererExtension渲染器扩展——负责真正把图片加载并渲染出来。没有它图片根本不会显示默认的行内渲染器会退化为把图片的原始 Markdown 语法当作普通文本渲染出来即页面上直接看到alt这样的字面文本。ImageSourceResolver源解析器——负责把原始 Markdown 目标字符串如alt中的my-image.png解析为完整、可加载的源字符串。它通过LocalMarkdownImageSourceResolver这个 composition local 提供。两个组件缺一不可且各自看不见对方的问题只有渲染器扩展、没有解析器在相对路径等需要解析的场景下可能加载失败只有解析器、没有渲染器扩展解析得再正确也依然什么都不显示。因此对于非平凡场景涉及相对路径、资源目录、远程地址混合必须同时接线两者。在 Jewel Markdown 的整体渲染流程中图片扩展属于渲染侧的扩展点。SKILL.md 明确建议图片请使用ImageRendererExtension而不是用一个通用的块渲染器去实现同时要遵守解析器扩展与渲染器扩展成对的原则——ImageRendererExtension是纯渲染侧的不要为它发明对应的处理器扩展也不要为纯解析类功能如 autolink去发明渲染器扩展。二、ImageRendererExtension渲染管线的入口ImageRendererExtension是一个接口其关键特征如下从MarkdownRendererExtension.imageRendererExtension暴露并添加到渲染器的扩展列表中默认的块渲染器DefaultMarkdownBlockRenderer会从块的行内内容中收集图片并把每一张图片交给第一个可用的imageRendererExtension渲染对应DefaultMarkdownBlockRenderer中的renderedImages(...)方法返回null表示没有图片例如加载出错此时渲染器会丢弃占位符而不是显示错误占位。这意味着只要注册了第一个可用的渲染器扩展块中所有图片都会流经它若它返回null该图片在 UI 上表现为不渲染。Coil3 参考实现Jewel 提供了一个基于 Coil3 的参考实现Coil3ImageRendererExtension是绝大多数场景下开箱即用的选择构造方式传入一个应用级app-wide的 CoilImageLoaderCoil3ImageRendererExtension(imageLoader)便捷构造Coil3ImageRendererExtension.withDefaultLoader()或withDefaultLoader(context)会创建一个带小型内存缓存的加载器。注意每次调用都会创建新的ImageLoader文档明确建议只创建一次并在进程级共享而不是反复调用内部实现行为通过LocalMarkdownImageSourceResolver.current解析源以Size.ORIGINAL请求图片将图片渲染进一个InlineTextContent其占位符会被调整到加载后图片的像素尺寸出错时返回null。从渲染流程上看ImageRendererExtension与代码高亮、URL 点击处理一样是按 UX 需求提供的能力之一SKILL.md 的 Validation checklist 中明确要求确认 code highlighting、image loading、URL click handling 在需要处均已提供。三、ImageSourceResolver路径解析的能力栈ImageSourceResolver同样是一个接口负责把 Markdown 里的图片目标字符串变成可加载的源。它通过LocalMarkdownImageSourceResolver提供默认值是ImageSourceResolver.create()使用默认能力。两种工厂方法ImageSourceResolver.create(resolveCapabilities, logResolveFailure) ImageSourceResolver.create(rootDir, logResolveFailure) // 追加 RelativePath(rootDir) 能力默认能力create()默认构造的解析器支持以下解析能力按顺序依次尝试第一个返回非 null 的结果胜出能力说明PlainUri绝对 URI 原样返回如https://...、file:///...RelativePathInResources(resourceClass?)相对路径在 classloader 的资源中查找AbsolutePath绝对文件系统路径原样返回而create(rootDir, ...)重载会额外追加RelativePath(rootDir)能力使相对路径可以基于某个基准目录解析——这是文档类应用以某个文档目录为根最常用的形态。失败语义如果所有能力都未能解析出结果且logResolveFailure为true解析器会记录失败日志并返回null该图片将不会加载。一个非常典型的故障就源于这里远程图片能显示、本地图片不能显示——通常意味着解析器缺少针对该路径形态的能力例如相对路径没有配rootDir。此时应改用rootDir重载或提供自定义解析器。四、完整接线让 Markdown 图片真正显示出来以下是文档给出的完整接线示例它同时接入了解析器与渲染器扩展// Provide a resolver (e.g. resolve relative paths against a doc root) val resolver ImageSourceResolver.create(rootDir docRoot, logResolveFailure true) ProvideMarkdownStyling( imageSourceResolver resolver, // overload that seeds LocalMarkdownImageSourceResolver markdownStyling styling, markdownBlockRenderer MarkdownBlockRenderer.light( styling styling, rendererExtensions listOf(Coil3ImageRendererExtension(imageLoader)), ), codeHighlighter codeHighlighter, ) { Markdown(blocks) }要点拆解ImageSourceResolver.create(rootDir docRoot, logResolveFailure true)以docRoot为基准目录解析相对路径并在解析失败时输出日志便于排查ProvideMarkdownStyling的imageSourceResolver参数这个重载会把解析器注入LocalMarkdownImageSourceResolverMarkdownBlockRenderer.light(...)的rendererExtensions注册Coil3ImageRendererExtension(imageLoader)其中imageLoader是进程级共享的 Coil 加载器codeHighlighter按需提供代码高亮与图片能力并列的另一个扩展点详见 CODE-HIGHLIGHTING.md。如果需要完全自定义的方案例如基于某个 base URL 或自有资源管线的路径方案可以直接实现ImageSourceResolver接口并通过LocalMarkdownImageSourceResolver或ProvideMarkdownStyling提供。从 SKILL.md 的接线上下文看ProvideMarkdownStyling负责把LocalMarkdownStyling、LocalMarkdownProcessor、LocalMarkdownBlockRenderer以及 code/image 支持统一接入JewelTheme——图片支持正是这条装配链中的一个环节。五、带尺寸的图片GitLab 属性块与 HTML 属性图片可以携带显式尺寸解析后被放入InlineMarkdown.Image的width/height字段类型为DimensionSize?。Jewel Markdown 支持两种源语法1. GitLab Markdown 图片属性块alt{width100 height50}属性块紧跟图片之后值可以是未加引号、单引号或双引号的形式接受纯数字无单位或带px后缀的值该属性块会从后续的文本节点中被消费掉因此不会作为字面文本出现在页面上。2. HTMLimg属性img srcimage.png width100 height50需要开启parseEmbeddedHtml true否则内嵌 HTML 不会按此路径处理width/height属性按与上面相同的方式解析。DimensionSize 的现状与边界DimensionSize目前只有一个变体DimensionSize.Pixels(value)且值为非负数目前只支持像素值/无单位值百分比和其他单位暂不支持%被记录为 JEWEL-1333 的 TODO无法解析或不支持的值会解析为null视为未指定一个{ ... }属性块若最终没有产生任何宽/高会作为字面文本保留下来。这一机制与 HTML 解析是联动的内嵌 HTML 的解析开关、内置标签转换等细节见 HTML-PARSING.mdimg属于parseEmbeddedHtml true时会被转换的内置标签之一。六、尺寸如何影响渲染三态规则InlineMarkdown.Image的 KDoc 定义了标准渲染器遵循的契约Coil3ImageRendererExtensionImpl实现了它。规则如下宽高指定情况渲染行为width和height都指定按精确尺寸渲染ContentScale.FillBounds如果宽高比与原始图片不同则会被拉伸只指定其中一个另一个按加载后图片的宽高比等比缩放ContentScale.Fit两者都不指定按图片固有加载尺寸渲染既有行为加载过程中已知的像素尺寸会被保留用于占位符未指定的尺寸会回退到最小占位符直到图片加载完成。特别重要的提示尺寸是节点上的数据渲染器并不会免费获得它。如果你编写自定义的ImageRendererExtension必须自行读取image.width/image.height并应用上面这条三态规则——否则尺寸设置将静默无效。七、自定义图片渲染实现你自己的扩展当 Coil3 参考实现不满足需求时可以直接实现ImageRendererExtension实现ImageRendererExtension.renderImageContent返回你自己的InlineTextContent尺寸占位符 composable通过LocalMarkdownImageSourceResolver.current解析原始源使路径处理保持一致出错时返回null表示该图片不渲染任何内容。核心原则路径解析永远走 composition local 中的 resolver不要在自定义渲染器里自行拼接路径否则会与全局的解析策略分叉。结合 SKILL.md 的通用规则自定义渲染器还有几个容易悄悄破坏的默认行为需要注意文本对齐LocalTextAlignment、内容颜色回退LocalContentColor、inlineContent映射包含图片的段落正是通过inlineContentmap 渲染的以及enabled状态。当你重写图片渲染时务必保持这些默认装配不被破坏。八、常见问题排查Gotchas文档列出了最常遇到的几类故障与对应解法按此清单逐项核对可以快速定位问题图片显示为文本 / Markdown 源码没有接线ImageRendererExtension。解决添加一个渲染器扩展如Coil3ImageRendererExtension。远程图片正常本地图片不显示解析器缺少针对该路径形态的能力例如相对路径没有rootDir。解决改用rootDir重载或提供自定义 resolver。样式 ≠ 加载MarkdownStyling.Image控制的是对齐、缩放、边框、背景等样式它不负责加载图片加载是扩展 解析器的责任。两者分工不同别在样式中找加载问题。反复创建 Coil 加载器共享单个 CoilImageLoader不要反复调用withDefaultLoader()每次调用都会新建加载器。尺寸不生效当前只支持像素/无单位尺寸%等其它单位会被忽略解析为未指定且自定义ImageRendererExtension必须自己处理image.width/image.height否则尺寸静默无效。九、与 Jewel Markdown 整体渲染流程的关系把图片机制放回 Jewel Markdown 的两阶段管线中看它的位置非常清晰MarkdownProcessor解析原始 Markdown 为ListMarkdownBlock块中包含InlineMarkdown节点图片即InlineMarkdown.ImageMarkdown在Column中渲染短内容LazyMarkdown在LazyColumn中渲染长内容或编辑器预览MarkdownBlockRenderer渲染块节点并把行内内容委托给InlineMarkdownRendererProvideMarkdownStyling把样式、处理器、块渲染器及 code/image 支持接入JewelTheme扩展可以挂入处理、块渲染与行内渲染三个阶段。图片加载处于第 45 步的交界处DefaultMarkdownBlockRenderer从行内内容收集图片、调用第一个可用的ImageRendererExtensionProvideMarkdownStyling负责把 resolver 注入 composition local。因此无论是排查图片不显示还是为编辑器预览MarkdownMode.EditorPreviewLazyMarkdown滚动同步细节见 SCROLL-SYNC.md接入图片检查清单都是同一套渲染器扩展是否注册、解析器是否具备对应能力、两者是否同时接线。结语Jewel Markdown 的图片加载并非单一功能点而是一对职责分明、必须协同工作的组件ImageRendererExtension解决如何渲染ImageSourceResolver解决从哪里加载。理解这两个组件的分工、默认能力栈的解析顺序、三态尺寸规则以及四类常见故障你就掌握了 Jewel Markdown 图片能力的完整心智模型。对任何图片不显示的问题都可以按照扩展是否接线 → 解析器能力是否覆盖 → 样式与加载是否混淆 → 加载器是否共享的顺序快速定位并修复。【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Jewel Markdown 图片加载机制全解：ImageRendererExtension 与 ImageSourceResolver 的接线指南
Jewel Markdown 图片加载机制全解ImageRendererExtension 与 ImageSourceResolver 的接线指南【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community本文基于 .claude/skills/jewel-markdown/references/IMAGE-LOADING.md 整理编写并结合同目录下的 SKILL.md 等配套文档进行补充说明。需要说明的是当前仓库为该项目的部分模块快照Jewel Markdown 的完整源码platform/jewel/markdown/未包含在本仓库中本文中涉及的所有 API 名称与行为均以技能文档记录为准未做任何外部推断。在 JewelJetBrains 的 Compose 跨平台 UI 工具包中Markdown 渲染是一个「先解析、后渲染」的两阶段管线MarkdownProcessor把原始 Markdown 解析为MarkdownBlock/InlineMarkdown模型再由 Jewel Compose 渲染器把模型变成真正的界面。图片是这个管线中最容易悄悄失效的一环——它不像标题、列表那样由通用块渲染器顺带处理而是依赖两个独立组件协同工作。本文以ImageRendererExtension图片渲染扩展和ImageSourceResolver图片源解析器为主线完整讲解 Jewel Markdown 图片加载的架构、接线方式、带尺寸图片的解析规则、自定义实现方法以及排查图片不显示类问题的常见陷阱。读完本文你将能够独立完成一个可加载本地相对路径与远程图片的 Jewel Markdown 渲染环境并能针对具体故障点精准定位修复。一、先理解架构图片加载由两个独立组件协作完成图片支持需要以下两个组件同时存在它们解决的是完全不同的问题ImageRendererExtension渲染器扩展——负责真正把图片加载并渲染出来。没有它图片根本不会显示默认的行内渲染器会退化为把图片的原始 Markdown 语法当作普通文本渲染出来即页面上直接看到alt这样的字面文本。ImageSourceResolver源解析器——负责把原始 Markdown 目标字符串如alt中的my-image.png解析为完整、可加载的源字符串。它通过LocalMarkdownImageSourceResolver这个 composition local 提供。两个组件缺一不可且各自看不见对方的问题只有渲染器扩展、没有解析器在相对路径等需要解析的场景下可能加载失败只有解析器、没有渲染器扩展解析得再正确也依然什么都不显示。因此对于非平凡场景涉及相对路径、资源目录、远程地址混合必须同时接线两者。在 Jewel Markdown 的整体渲染流程中图片扩展属于渲染侧的扩展点。SKILL.md 明确建议图片请使用ImageRendererExtension而不是用一个通用的块渲染器去实现同时要遵守解析器扩展与渲染器扩展成对的原则——ImageRendererExtension是纯渲染侧的不要为它发明对应的处理器扩展也不要为纯解析类功能如 autolink去发明渲染器扩展。二、ImageRendererExtension渲染管线的入口ImageRendererExtension是一个接口其关键特征如下从MarkdownRendererExtension.imageRendererExtension暴露并添加到渲染器的扩展列表中默认的块渲染器DefaultMarkdownBlockRenderer会从块的行内内容中收集图片并把每一张图片交给第一个可用的imageRendererExtension渲染对应DefaultMarkdownBlockRenderer中的renderedImages(...)方法返回null表示没有图片例如加载出错此时渲染器会丢弃占位符而不是显示错误占位。这意味着只要注册了第一个可用的渲染器扩展块中所有图片都会流经它若它返回null该图片在 UI 上表现为不渲染。Coil3 参考实现Jewel 提供了一个基于 Coil3 的参考实现Coil3ImageRendererExtension是绝大多数场景下开箱即用的选择构造方式传入一个应用级app-wide的 CoilImageLoaderCoil3ImageRendererExtension(imageLoader)便捷构造Coil3ImageRendererExtension.withDefaultLoader()或withDefaultLoader(context)会创建一个带小型内存缓存的加载器。注意每次调用都会创建新的ImageLoader文档明确建议只创建一次并在进程级共享而不是反复调用内部实现行为通过LocalMarkdownImageSourceResolver.current解析源以Size.ORIGINAL请求图片将图片渲染进一个InlineTextContent其占位符会被调整到加载后图片的像素尺寸出错时返回null。从渲染流程上看ImageRendererExtension与代码高亮、URL 点击处理一样是按 UX 需求提供的能力之一SKILL.md 的 Validation checklist 中明确要求确认 code highlighting、image loading、URL click handling 在需要处均已提供。三、ImageSourceResolver路径解析的能力栈ImageSourceResolver同样是一个接口负责把 Markdown 里的图片目标字符串变成可加载的源。它通过LocalMarkdownImageSourceResolver提供默认值是ImageSourceResolver.create()使用默认能力。两种工厂方法ImageSourceResolver.create(resolveCapabilities, logResolveFailure) ImageSourceResolver.create(rootDir, logResolveFailure) // 追加 RelativePath(rootDir) 能力默认能力create()默认构造的解析器支持以下解析能力按顺序依次尝试第一个返回非 null 的结果胜出能力说明PlainUri绝对 URI 原样返回如https://...、file:///...RelativePathInResources(resourceClass?)相对路径在 classloader 的资源中查找AbsolutePath绝对文件系统路径原样返回而create(rootDir, ...)重载会额外追加RelativePath(rootDir)能力使相对路径可以基于某个基准目录解析——这是文档类应用以某个文档目录为根最常用的形态。失败语义如果所有能力都未能解析出结果且logResolveFailure为true解析器会记录失败日志并返回null该图片将不会加载。一个非常典型的故障就源于这里远程图片能显示、本地图片不能显示——通常意味着解析器缺少针对该路径形态的能力例如相对路径没有配rootDir。此时应改用rootDir重载或提供自定义解析器。四、完整接线让 Markdown 图片真正显示出来以下是文档给出的完整接线示例它同时接入了解析器与渲染器扩展// Provide a resolver (e.g. resolve relative paths against a doc root) val resolver ImageSourceResolver.create(rootDir docRoot, logResolveFailure true) ProvideMarkdownStyling( imageSourceResolver resolver, // overload that seeds LocalMarkdownImageSourceResolver markdownStyling styling, markdownBlockRenderer MarkdownBlockRenderer.light( styling styling, rendererExtensions listOf(Coil3ImageRendererExtension(imageLoader)), ), codeHighlighter codeHighlighter, ) { Markdown(blocks) }要点拆解ImageSourceResolver.create(rootDir docRoot, logResolveFailure true)以docRoot为基准目录解析相对路径并在解析失败时输出日志便于排查ProvideMarkdownStyling的imageSourceResolver参数这个重载会把解析器注入LocalMarkdownImageSourceResolverMarkdownBlockRenderer.light(...)的rendererExtensions注册Coil3ImageRendererExtension(imageLoader)其中imageLoader是进程级共享的 Coil 加载器codeHighlighter按需提供代码高亮与图片能力并列的另一个扩展点详见 CODE-HIGHLIGHTING.md。如果需要完全自定义的方案例如基于某个 base URL 或自有资源管线的路径方案可以直接实现ImageSourceResolver接口并通过LocalMarkdownImageSourceResolver或ProvideMarkdownStyling提供。从 SKILL.md 的接线上下文看ProvideMarkdownStyling负责把LocalMarkdownStyling、LocalMarkdownProcessor、LocalMarkdownBlockRenderer以及 code/image 支持统一接入JewelTheme——图片支持正是这条装配链中的一个环节。五、带尺寸的图片GitLab 属性块与 HTML 属性图片可以携带显式尺寸解析后被放入InlineMarkdown.Image的width/height字段类型为DimensionSize?。Jewel Markdown 支持两种源语法1. GitLab Markdown 图片属性块alt{width100 height50}属性块紧跟图片之后值可以是未加引号、单引号或双引号的形式接受纯数字无单位或带px后缀的值该属性块会从后续的文本节点中被消费掉因此不会作为字面文本出现在页面上。2. HTMLimg属性img srcimage.png width100 height50需要开启parseEmbeddedHtml true否则内嵌 HTML 不会按此路径处理width/height属性按与上面相同的方式解析。DimensionSize 的现状与边界DimensionSize目前只有一个变体DimensionSize.Pixels(value)且值为非负数目前只支持像素值/无单位值百分比和其他单位暂不支持%被记录为 JEWEL-1333 的 TODO无法解析或不支持的值会解析为null视为未指定一个{ ... }属性块若最终没有产生任何宽/高会作为字面文本保留下来。这一机制与 HTML 解析是联动的内嵌 HTML 的解析开关、内置标签转换等细节见 HTML-PARSING.mdimg属于parseEmbeddedHtml true时会被转换的内置标签之一。六、尺寸如何影响渲染三态规则InlineMarkdown.Image的 KDoc 定义了标准渲染器遵循的契约Coil3ImageRendererExtensionImpl实现了它。规则如下宽高指定情况渲染行为width和height都指定按精确尺寸渲染ContentScale.FillBounds如果宽高比与原始图片不同则会被拉伸只指定其中一个另一个按加载后图片的宽高比等比缩放ContentScale.Fit两者都不指定按图片固有加载尺寸渲染既有行为加载过程中已知的像素尺寸会被保留用于占位符未指定的尺寸会回退到最小占位符直到图片加载完成。特别重要的提示尺寸是节点上的数据渲染器并不会免费获得它。如果你编写自定义的ImageRendererExtension必须自行读取image.width/image.height并应用上面这条三态规则——否则尺寸设置将静默无效。七、自定义图片渲染实现你自己的扩展当 Coil3 参考实现不满足需求时可以直接实现ImageRendererExtension实现ImageRendererExtension.renderImageContent返回你自己的InlineTextContent尺寸占位符 composable通过LocalMarkdownImageSourceResolver.current解析原始源使路径处理保持一致出错时返回null表示该图片不渲染任何内容。核心原则路径解析永远走 composition local 中的 resolver不要在自定义渲染器里自行拼接路径否则会与全局的解析策略分叉。结合 SKILL.md 的通用规则自定义渲染器还有几个容易悄悄破坏的默认行为需要注意文本对齐LocalTextAlignment、内容颜色回退LocalContentColor、inlineContent映射包含图片的段落正是通过inlineContentmap 渲染的以及enabled状态。当你重写图片渲染时务必保持这些默认装配不被破坏。八、常见问题排查Gotchas文档列出了最常遇到的几类故障与对应解法按此清单逐项核对可以快速定位问题图片显示为文本 / Markdown 源码没有接线ImageRendererExtension。解决添加一个渲染器扩展如Coil3ImageRendererExtension。远程图片正常本地图片不显示解析器缺少针对该路径形态的能力例如相对路径没有rootDir。解决改用rootDir重载或提供自定义 resolver。样式 ≠ 加载MarkdownStyling.Image控制的是对齐、缩放、边框、背景等样式它不负责加载图片加载是扩展 解析器的责任。两者分工不同别在样式中找加载问题。反复创建 Coil 加载器共享单个 CoilImageLoader不要反复调用withDefaultLoader()每次调用都会新建加载器。尺寸不生效当前只支持像素/无单位尺寸%等其它单位会被忽略解析为未指定且自定义ImageRendererExtension必须自己处理image.width/image.height否则尺寸静默无效。九、与 Jewel Markdown 整体渲染流程的关系把图片机制放回 Jewel Markdown 的两阶段管线中看它的位置非常清晰MarkdownProcessor解析原始 Markdown 为ListMarkdownBlock块中包含InlineMarkdown节点图片即InlineMarkdown.ImageMarkdown在Column中渲染短内容LazyMarkdown在LazyColumn中渲染长内容或编辑器预览MarkdownBlockRenderer渲染块节点并把行内内容委托给InlineMarkdownRendererProvideMarkdownStyling把样式、处理器、块渲染器及 code/image 支持接入JewelTheme扩展可以挂入处理、块渲染与行内渲染三个阶段。图片加载处于第 45 步的交界处DefaultMarkdownBlockRenderer从行内内容收集图片、调用第一个可用的ImageRendererExtensionProvideMarkdownStyling负责把 resolver 注入 composition local。因此无论是排查图片不显示还是为编辑器预览MarkdownMode.EditorPreviewLazyMarkdown滚动同步细节见 SCROLL-SYNC.md接入图片检查清单都是同一套渲染器扩展是否注册、解析器是否具备对应能力、两者是否同时接线。结语Jewel Markdown 的图片加载并非单一功能点而是一对职责分明、必须协同工作的组件ImageRendererExtension解决如何渲染ImageSourceResolver解决从哪里加载。理解这两个组件的分工、默认能力栈的解析顺序、三态尺寸规则以及四类常见故障你就掌握了 Jewel Markdown 图片能力的完整心智模型。对任何图片不显示的问题都可以按照扩展是否接线 → 解析器能力是否覆盖 → 样式与加载是否混淆 → 加载器是否共享的顺序快速定位并修复。【免费下载链接】intellij-communityIntelliJ IDEA IntelliJ Platform项目地址: https://gitcode.com/GitHub_Trending/in/intellij-community创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考