#概览

react-wikitext 把 MediaWiki 风格的 wikitext 渲染成 React 元素：源码先由解析器转换为强类型语义 AST，再转换为 HAST，最后交给 React。它不连接 MediaWiki API，不执行 Lua，也不接管站点路由。

#它解决什么问题

在 React 应用里展示 wiki 内容时，常见做法是拿到 HTML 后用 dangerouslySetInnerHTML 注入，或者直接嵌入 iframe。前者绕过了 React，后者无法复用宿主样式与交互。

react-wikitext 输出 React 元素而不是 HTML 字符串；渲染前会给出可查询的语义树与已清洗的 HAST；链接、图片和模板由宿主决定，库只负责校验与渲染。解析与准备可以放在服务端、Worker 或缓存层，客户端只接收快照。

#能力

#默认输出

下面的示例没有配置解析函数。模板、图片占位与未配置路由的链接都是默认行为，不是渲染失败：

import { Wikitext } from "react-wikitext";
import "react-wikitext/styles.css";

const source = `== 默认输出 ==
这段文字包含 '''粗体'''、''斜体'' 和 [[尚未配置路由的链接]]。

{{Infobox|title=模板默认不求值}}

[[File:Example.png|thumb|图片默认只是占位]]`;

export default function Demo() {
  return <Wikitext source={source} lang="zh-CN" />;
}

完整行为见渲染行为与支持矩阵。

#明确的边界

默认管线不求值模板与解析器函数，也不执行 Lua；/expand 只覆盖受支持的子集。库不发起网络请求，图片默认不加载，内部链接默认不可导航。

它不是 MediaWiki 实现，也不含编辑器或虚拟列表；站点 API、编辑流程、完整扩展语义与分页调度由宿主负责。完整边界见渲染行为。

#适用场景

适合只读的 wiki 镜像、存档与导出，也适合在知识库、文档站或后台中嵌入片段。需要在渲染前检查结构化数据、按块容错、把解析放到 Worker，或把链接、图片、模板接到自有路由与后端时，也可以使用本库。

以下场景更适合其他方案：

#当前状态

兼容矩阵与版本策略见状态与兼容性。

#从这里开始

• 快速开始：安装并渲染第一段源码。
• 工作原理：理解管线、快照与入口的拆分。
• 支持矩阵：确认某段语法会被渲染、占位还是降级。