UI组件移动开发【免费下载链接】MarkwonAndroid markdown library (no WebView)项目地址https://gitcode.com/gh_mirrors/ma/Markwon点击查看免费下载Markwon 是一个不依赖 WebView 的 Android Markdown 渲染库。自 3.0.0 版本起MarkwonHtmlRenderer成为其 HTML 内容渲染的控制中枢它把 Markdown 解析阶段产生的HtmlBlock/HtmlInline节点转化为原生 AndroidSpannable。本文基于 docs/docs/v3/core/html-renderer.md 展开结合仓库源码系统讲解如何通过configureHtmlRenderer注册自定义TagHandler、处理非闭合标签以及内置markwon-html模块的渲染原理帮助你为a、div等任意 HTML 标签定制渲染行为。一、前置条件显式引入 markwon-html 与 HtmlPluginMarkwonHtmlRenderer只是渲染器的配置入口它本身并不负责解析 HTML。文档中特别强调CustomizingMarkwonHtmlRendereris not enough to include HTML content in your application. You must explicitly includemarkwon-htmlartifact (includes HtmlParser) and registerHtmlPlugin.因此要使用 HTML 渲染能力必须同时完成两件事在 Gradle 中引入markwon-html模块该模块自 2.0.0 起把 HTML 解析能力从 core 中剥离并内置了修改版 jsoup避免在不需要 HTML 渲染的 App 中引入多余依赖。在构建Markwon时注册HtmlPluginfinal Markwon markwon Markwon.builder(context) .usePlugin(HtmlPlugin.create()) .build();HtmlPlugin的核心职责见 HtmlPlugin.java包括在configureVisitor阶段注册HtmlBlock、HtmlInline节点的NodeVisitor把解析出的 HTML 字面量逐段交给MarkwonHtmlParser.processFragment处理在configureConfiguration阶段构建内部MarkwonHtmlRendererImpl.Builder并注册一批默认TagHandler在afterRender阶段调用htmlRenderer.render(visitor, htmlParser)完成对整个文档 HTML 标签的最终渲染。注意configureHtmlRenderer仅作用于渲染器配置若未注册HtmlPluginMarkdown 中的 HTML 内容将不会进入渲染管线。二、渲染器配置入口configureHtmlRendererAbstractMarkwonPlugin提供了configureHtmlRenderer(MarkwonHtmlRenderer.Builder)回调所有自定义渲染配置都应在这里完成。基础用法如下Markwon.builder(context) .usePlugin(new AbstractMarkwonPlugin() { Override public void configureHtmlRenderer(NonNull MarkwonHtmlRenderer.Builder builder) { builder.setHandler(a, new MyTagHandler()); } });从源码结构看MarkwonHtmlRenderer.Builder在 MarkwonHtmlRendererImpl.java 中维护了一个MapString, TagHandler tagHandlerssetHandler会把标签名映射到对应处理器。构建完成后如果没有任何TagHandler注册Builder 会退回MarkwonHtmlRendererNoOp空实现这解释了为何单独配置渲染器而不引入HtmlPlugin时不会产生任何 HTML 渲染效果。三、自定义 HTML 标签处理器的两种方式3.1 SimpleTagHandler简单场景的首选当某个标签不需要特殊处理例如不需要遍历其子节点时可以继承SimpleTagHandler。示例为a标签创建链接处理器。builder.setHandler(a, new SimpleTagHandler() { Override public Object getSpans( NonNull MarkwonConfiguration configuration, NonNull RenderProps renderProps, NonNull HtmlTag tag) { return new LinkSpan( configuration.theme(), tag.attributes().get(href), configuration.linkResolver()); } });SimpleTagHandler见 SimpleTagHandler.java的handle方法内部逻辑是若标签是块级标签tag.isBlock()先调用visitChildren遍历其子块调用用户实现的getSpans获得样式对象若spans ! null通过SpannableBuilder.setSpans(visitor.builder(), spans, tag.start(), tag.end())应用到输出文本区间。getSpans可以返回null表示不应用任何 Span、单个 Span或一个 Span 数组文档明确提示 One can returnnull, a single span or an array of spans。SpannableBuilder.setSpans对这三种情况均有兼容处理。3.2 TagHandler面向高级场景的完整接口当标签需要精细控制如访问并修改子节点渲染、读取/改写RenderProps、手动应用 Span时应直接实现TagHandlerbuilder.setHandler(a, new TagHandler() { Override public void handle(NonNull MarkwonVisitor visitor, NonNull MarkwonHtmlRenderer renderer, NonNull HtmlTag tag) { // obtain default spanFactory for Link node final SpanFactory factory visitor.configuration().spansFactory().get(Link.class); if (factory ! null) { // set destination property CoreProps.LINK_DESTINATION.set( visitor.renderProps(), tag.attributes().get(href)); // Obtain spans from the factory final Object spans factory.getSpans( visitor.configuration(), visitor.renderProps()); // apply spans to SpannableBuilder SpannableBuilder.setSpans( visitor.builder(), spans, tag.start(), tag.end()); } } });这段示例展示了TagHandler的完整工作流从visitor.configuration().spansFactory()取出 MarkdownLink节点默认的SpanFactory通过CoreProps.LINK_DESTINATION把href属性写入RenderProps调用工厂方法生成 Span再应用到SpannableBuilder的对应区间。TagHandler基类见 TagHandler.java自 4.0.0 起还要求实现supportedTags()返回该处理器支持的标签名集合——这正是Builder.addHandler把标签名注册进内部 Map 的依据void addHandler(NonNull TagHandler tagHandler) { checkState(); for (String tag : tagHandler.supportedTags()) { tagHandlers.put(tag, tagHandler); } }基类还提供了受保护的visitChildren(visitor, renderer, HtmlTag.Block)静态方法用于手动遍历块级标签的子块遍历时若子块未闭合!child.isClosed()则跳过。3.3 标签信息模型HtmlTag无论哪种处理器都会收到一个HtmlTag对象HtmlTag.java它提供方法说明name()归一化后的标签名小写start()/end()标签在输出文本中的起始/结束索引isClosed()标签是否闭合有合法的 start 与 endisEmpty()是否无内容start endattributes()标签属性 MapisInline()/isBlock()是否为行内/块级标签getAsInline()/getAsBlock()转换为对应子接口块级标签HtmlTag.Block额外提供parent()、children()、isRoot()用于表达块级标签的嵌套树结构。四、渲染管线与默认 TagHandler4.1 两阶段 flush 渲染MarkwonHtmlRendererImpl.render见 MarkwonHtmlRendererImpl.java的渲染分为两个阶段parser.flushInlineTags(...)处理所有行内标签对每个isClosed()的标签查找处理器并调用handleparser.flushBlockTags(...)处理所有块级标签若某个块级标签没有注册处理器则递归处理其children()避免丢失嵌套在未知标签内部的内容最后调用parser.reset()清空解析器内部状态。4.2 内置标签处理器HtmlPlugin注册的默认TagHandler见HtmlPlugin.configureConfiguration包括imgImageHandler.create()aLinkHandlerblockquoteBlockquoteHandlersubSubScriptHandler、supSuperScriptHandlerb, strongStrongEmphasisHandlers, delStrikeHandleru, insUnderlineHandlerul, olListHandleri, cite, em, dfnEmphasisHandlerh1 ~ h6HeadingHandler关键设计所有预定义处理器都复用 Markdown 原生内容的样式 Span。例如 LinkHandler.java 的实现与上文TagHandler示例完全一致——从spansFactory取Link工厂、设置CoreProps.LINK_DESTINATION、调用getSpans。这意味着若你的Markwon配置了 Emphasis 节点渲染为红色文字HTMLem标签也会使用同样的红色 Span图片、链接、UrlResolver、LinkProcessor 等配置同样共享。HtmlPlugin还提供excludeDefaults(true)来排除全部默认处理器配合TagHandlerNoOp可单独禁用某些默认标签的行为例如禁用a的默认渲染。五、非闭合标签处理allowNonClosedTagsHTML 规范要求标签必须闭合但实际内容中常见div这类未闭合的标签。Markwon 默认拒绝并忽略非闭合标签如需显式放行可通过 Builder 配置final Markwon markwon Markwon.builder(context) .usePlugin(new AbstractMarkwonPlugin() { Override public void configureHtmlRenderer(NonNull MarkwonHtmlRenderer.Builder builder) { builder.allowNonClosedTags(true); } }) .build();注意allowNonClosedTags(true)开启后所有未闭合标签会在文档末尾被强制闭合。其底层逻辑在MarkwonHtmlRendererImpl.render中未开启时end HtmlTag.NO_END即 -1非闭合标签在 flush 时因isClosed() false被跳过开启后end visitor.length()解析器在文档末尾以该长度闭合所有未闭合标签。HtmlTag.NO_END常量为 -1与isClosed()配合即可在任何自定义处理器中判断标签是否真正闭合。另外自 4.0.0 起HtmlPlugin自身也暴露了同名的allowNonClosedTags(boolean)方法见HtmlPlugin.java可直接链式调用HtmlPlugin.create() .allowNonClosedTags(true) .excludeDefaults(false) .addHandler(new MyTagHandler());六、空标签替换HtmlEmptyTagReplacement若标签为空如br、img、自闭合标签、my-custom-element/my-custom-element标签的 start 与 end 相等无法直接应用 Span。HtmlPlugin自 4.4.0 起通过HtmlEmptyTagReplacementHtmlEmptyTagReplacement.java处理br→ 替换为换行符\nimg→ 无alt属性时替换为占位符\uFFFC对象替换字符有alt时替换为alt文本iframe→ 替换为不间断空格\u00a04.4.0 起使 iframe 非空便于后续应用 Span其他标签 → 返回null不替换标签 start 与 end 保持相等不适用于应用 Span。可通过HtmlPlugin.create().emptyTagReplacement(...)传入自定义实现为标签生成占位文本以承载样式。七、小结与完整示例MarkwonHtmlRenderer的完整使用路径可归纳为引入markwon-html依赖并注册HtmlPlugin在configureHtmlRenderer中通过setHandler(tagName, handler)注册自定义处理器简单标签用SimpleTagHandler需遍历子节点或精细控制时用TagHandler必要时开启allowNonClosedTags(true)放行未闭合标签或通过HtmlEmptyTagReplacement处理空标签所有处理器均与 Markdown 原生 Span 体系共享配置保证 HTML 与 Markdown 内容视觉一致。一个覆盖上述要素的完整示例final Markwon markwon Markwon.builder(context) .usePlugin(HtmlPlugin.create()) .usePlugin(new AbstractMarkwonPlugin() { Override public void configureHtmlRenderer(NonNull MarkwonHtmlRenderer.Builder builder) { builder.setHandler(my-tag, new SimpleTagHandler() { Override public Object getSpans( NonNull MarkwonConfiguration configuration, NonNull RenderProps renderProps, NonNull HtmlTag tag) { return new ForegroundColorSpan(Color.RED); } NonNull Override public CollectionString supportedTags() { return Collections.singleton(my-tag); } }); } }) .build();渲染后的Spannable可直接交给TextView显示无需 WebView即实现 Markdown 与 HTML 混排的原生渲染。参考资源本文主体文档docs/docs/v3/core/html-renderer.mdmarkwon-html 模块总览docs/docs/v3/html/README.md渲染器实现MarkwonHtmlRendererImpl.java插件入口HtmlPlugin.java处理器接口TagHandler.java、SimpleTagHandler.java标签模型HtmlTag.java空标签替换HtmlEmptyTagReplacement.java内置链接处理器示例LinkHandler.java赞分享UI组件移动开发【免费下载链接】MarkwonAndroid markdown library (no WebView)项目地址https://gitcode.com/gh_mirrors/ma/Markwon点击查看免费下载相关推荐Markwon HTML 解析与渲染实战指南从 CommonMark 的 HtmlBlock/HtmlInline 到自研渲染管线Markwon HTML 解析与渲染实战指南从 CommonMark 的 HtmlBlock/HtmlInline 到自研渲染管线 导读 本文基于 MarkwUI组件移动开发Akkudoktor EOS Markdown渲染自定义渲染器与HTML生成Akkudoktor EOS Markdown渲染自定义渲染器与HTML生成 引言为什么需要自定义Markdown渲染 在现代Web应用开发中Markd后端智能家居ToolJet HTML Viewer 组件详解自定义 HTML-CSS 布局的渲染原理与完整属性指南ToolJet HTML Viewer 组件详解自定义 HTML CSS 布局的渲染原理与完整属性指南 HTML Viewer 是 ToolJet 官方文档低代码后端前端AI 应用MCP 服务上一篇Machine-Learning-Tutorials实验跟踪MLflow与Weights Biases终极指南下一篇探索GPT2-Small的稀疏自动编码器揭示神经网络的秘密维度创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考