# react-wikitext

> React components for rendering wikitext.

## 指南

- [概览](/zh/guide/introduction.md): react-wikitext 的定位、能力边界、适用场景与当前状态。
- [快速开始](/zh/guide/quick-start.md): 安装 react-wikitext，并把一段 wikitext 渲染为 React 元素。
- [工作原理](/zh/guide/concepts.md): 处理管线、两种快照、入口加载边界与语义归一化的基本原则。
- [基本用法](/zh/guide/usage.md): 源码组件、显式管线、异步插件与组件覆盖。
- [服务端与框架](/zh/guide/server-rendering.md): 服务端准备渲染快照、跨边界传输、Next.js App Router 与 hydration 注意事项。
- [渲染行为](/zh/guide/rendering.md): 默认管线如何呈现 wikitext，以及当前稳定的行为边界。
- [支持矩阵](/zh/guide/syntax-support.md): 常见 wikitext 构造在默认管线中的输出与状态速查。
- [链接与图片](/zh/guide/links-and-images.md): 用 resolveLink 与 resolveImage 接入站内路由、外部链接和媒体服务。
- [模板展开](/zh/guide/templates.md): 在解析前用宿主提供的解析函数展开受支持的模板与纯 wikitext 解析器函数。
- [样式与组件定制](/zh/guide/customization.md): 主题变量、文案、标题锚点、插件与组件覆盖点。
- [性能与预算](/zh/guide/performance.md): 解析与准备的成本、预算上限、Worker、缓存与按入口拆分打包。
- [安全模型](/zh/guide/security.md): 默认安全边界、最终清洗顺序，以及宿主需要自行处理的部分。
- [常用配方](/zh/guide/recipes.md): 主题、链接与图片、模板卡片、文章目录与错误上报的可复制片段。
- [故障排查](/zh/guide/troubleshooting.md): 常见显示、构建与错误码问题，以及定位问题的固定步骤。

## 参考

- [入口总览](/zh/api/index.md): 子路径提供的功能、加载边界与解析/渲染快照的区别。
- [React 组件](/zh/api/react.md): Wikitext、WikitextView、WikitextFragment、覆盖组件与 Context Hook。
- [解析 /parse](/zh/api/parse.md): 默认解析器、解析选项、预算、自定义适配器与解析错误。
- [AST /ast](/zh/api/ast.md): 语义节点模型、查询辅助函数、源码归一化与解析快照序列化。
- [准备 /hast](/zh/api/prepare.md): 语义树插件、解析函数、安全策略、标题锚点与渲染快照。
- [展开 /expand](/zh/api/expand.md): expandWikitext 的选项、解析函数、结果、预算与错误。
- [unified](/zh/api/unified.md): raw 模式：把解析、语义转 HAST 与最终整理注册到你自己的 unified 处理器。
- [configs](/zh/api/configs.md): MEDIAWIKI_CONFIG 与 ParserConfig。
- [错误与诊断](/zh/api/errors.md): 错误类、错误码、诊断字段与处理建议。

## 项目

- [状态与兼容性](/zh/project/status.md): 版本状态、运行时兼容矩阵、固定上游版本、快照版本与许可。
- [参与与反馈](/zh/project/contributing.md): 报告问题、运行文档站、修改文档与提交前检查。