搜索插件、代码仓与 APP 分类

插件详情v1.4.1

gpt_markdown

强大的 Flutter Markdown 和 LaTeX 渲染器:富文本、数学公式、表格、链接和文本选择。适用于 ChatGPT、Gemini 等应用。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
18.9万
喜欢数
344
Pub 分数
160

安装插件

flutter pub add gpt_markdown

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

gpt_markdown 是一个功能强大的 Flutter 包,用于渲染 Markdown 和 LaTeX,并支持丰富的文本格式,包括数学表达式、表格、链接和文本选择。专为聊天界面和人工智能应用设计,可在 Android、iOS、Web、macOS、Windows 和 Linux 上实现高保真度的格式化效果。该包通过准确显示结构化内容并提供动态交互性,显著提升了类似 ChatGPT 或 Gemini 等应用的用户体验。

适合场景

  • AI聊天界面
  • 文档渲染
  • 数学内容显示
  • 基于网络的交互式笔记
  • 跨平台应用内容
  • 富文本消息

主要特点

  • 支持 LaTeX 数学渲染
  • 完整的 Markdown 语法兼容性
  • 文本选择和复制
  • 响应式表格布局
  • 跨平台一致性
  • 高性能渲染

适合对象

  • 开发 AI 聊天应用的开发者
  • 包含数学内容的教育平台
  • 技术文档查看器
  • 内容丰富的移动和Web应用
  • 需要一致 Markdown 输出的团队

使用建议

  • 需要谨慎处理不受信任的输入
  • 可能需要对非常大的文档进行优化
  • LaTeX 渲染依赖外部依赖项
  • 高级样式定制有限
  • 最适合静态或半动态内容

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

gpt_markdown logo

gpt_markdown

The Flutter renderer for AI output.

Production-grade Markdown and LaTeX rendering for streaming Flutter AI interfaces.
Render rich assistant replies, math, code, tables, citations, images, and custom inline UI in one widget.

Pub Version Pub Likes Pub Points BSD-3-Clause license

🌐 Website · 📖 Documentation · 🎮 Live Playground · 📦 pub.dev


✨ Why gpt_markdown?

  • Built for AI output — Markdown, LaTeX, code blocks, tables, citations, images, task lists, and mixed rich content in one response.
  • Streaming that stays fast — settled segments are reused while the live tail updates. At 12 KB, each update is 31× faster than in 1.2.1—or 74× faster with the lazy sliver. See the benchmarks.
  • Production-level control — style sheets, Flutter theme extensions, component builders, callbacks, and custom components.
  • Extensible inline UI — add @mentions, #channels, :emoji:, issue references, and product-specific syntax without forking the renderer.
  • Designed for real-world edge cases — RTL, text scaling, selection, malformed Markdown, autolinks, nested content, reduced motion, Flutter web, and WASM.

🧩 Everything AI output needs

Rendering Production experience Extensibility
📝 Rich Markdown ⚡ Adaptive streaming 🎨 Component style sheet
∑ Inline and block LaTeX 🚀 Lazy sliver rendering 🧱 Structural builders
💻 Syntax-highlighted code ♿ Selection and text scaling 🏷️ Mentions, channels, and emoji
📊 Tables and aligned columns 🌍 RTL, web, and WASM 🧩 Custom components and scopes
🔗 Links, autolinks, and images 🌓 Theme-aware rendering 👆 Interaction callbacks
☑️ Lists, tasks, and citations 🛡️ Graceful malformed input 📱 Custom URL schemes

🖼️ What it renders

Every image is one GptMarkdown widget with no styling applied — the defaults, in a dark theme. Click any of them for full size.

Rich text rendered by gpt_markdown
Rich text
Headings, emphasis, lists, quotes, rules, autolinks.
LaTeX rendered by gpt_markdown
LaTeX
Inline and display equations, on the text baseline.
Tables rendered by gpt_markdown
Tables
Per-column alignment, Markdown inside cells.
Code rendered by gpt_markdown
Code
Syntax highlighting, language labels, and copy controls.
Task lists rendered by gpt_markdown
Task lists
Checkboxes, ordered and nested lists, citation tags.
Inline patterns rendered by gpt_markdown
Inline patterns
Mentions, channels, shortcodes. #2959 stays text.

🛠️ Quick start

flutter pub add gpt_markdown
import 'package:gpt_markdown/gpt_markdown.dart';

GptMarkdown(
  reply,
  onLinkTap: (url, title) => openUrl(url),
)

The widget sizes itself to its content. Place it inside your preferred scrollable chat or document surface.

⚡ Streaming AI responses

Rebuild GptMarkdown with the complete text received so far. Settled segments are reused while the changing tail updates.

GptMarkdown(
  streamedReply,
  animation: GptMarkdownAnimation.fade,
  blockAnimation: GptMarkdownBlockAnimation.fadeIn,
  isStreaming: stillGenerating,
  charactersPerSecond: 300,
)

The reveal adapts to incoming text, finishes when generation ends, and respects reduced-motion settings. See the streaming guide for animation modes and configuration.

For long responses and documents, use SliverGptMarkdown inside a CustomScrollView. It creates spans and widgets only for the segments requested by the viewport, including its cache extent. The regular GptMarkdown widget is cheaper for short content and remains the option for character reveal. See the rendering architecture guide.

📝 Markdown, LaTeX, and rich AI output

GptMarkdown(
  r'''
## Revenue forecast

Projected growth: **18%**.

\[
R_{next} = R_{current} \times (1 + 0.18)
\]

- [x] Validate the assumptions
- [ ] Review the final forecast

Sources: [1] [2]
  ''',
  onSourceTagTap: (source) => openSource(source),
)

Use \( ... \) for inline LaTeX and \[ ... \] for block equations. Enable dollar-sign syntax with useDollarSignsForLatex: true. Code fences include syntax highlighting, language labels, and copy controls.

Wrap the renderer with SelectionArea when selectable output is needed:

SelectionArea(
  child: GptMarkdown(reply),
)

🎨 Make it match your product

Use style objects for appearance and builders when you need to replace structure.

GptMarkdown(
  reply,
  styleSheet: const GptMarkdownStyleSheet(
    blockQuote: BlockQuoteStyle(
      barWidth: 4,
      barColor: Colors.indigo,
    ),
    inlineCode: InlineCodeStyle(
      fontFamily: 'GeistMono',
      borderRadius: Radius.circular(6),
    ),
    codeBlock: CodeBlockStyle(
      borderRadius: Radius.circular(12),
      showCopyButton: true,
    ),
    table: TableStyle(
      cellPadding: EdgeInsets.all(10),
    ),
  ),
  onCodeCopy: (code) => trackCopy(code),
  onImageTap: (url) => openImage(url),
)

Set styles app-wide with GptMarkdownThemeData. Use builders such as codeBuilder, tableBuilder, and imageBuilder to replace components, or span-based builders for links, citations, and inline code. See customization.

🏷️ App-specific inline UI

Render mentions, channels, emoji, issue references, and other product syntax alongside Markdown:

GptMarkdown(
  reply,
  inlinePatterns: [
    InlinePattern.prefixed(
      prefix: '#',
      knownNames: channelNames,
      builder: (context, match, style) => WidgetSpan(
        alignment: PlaceholderAlignment.baseline,
        baseline: TextBaseline.alphabetic,
        child: ChannelChip(
          name: match.group(0)!.substring(1),
        ),
      ),
    ),
  ],
)

Only known channel names are matched, longest-first. Patterns exclude link labels by default; unrecognized tokens such as #2959 remain text.

Use blockComponents for custom blocks and inlineDirectives for payloads the parser must leave untouched. See custom components.

Upgrading? Passing components or inlineComponents, even an empty list, selects the deprecated legacy parser. Replace them to use the new pipeline. See the migration guide and changelog.

🔗 Autolinks

Bare URLs, www. hosts, emails, and angle autolinks work automatically. Add custom schemes with autolinkSchemes: const {'myapp'}, or disable autolinking with autolink: false. Explicit [label](url) links still work. See inline syntax.

📚 Documentation

Guide Covers
Getting started Installation, syntax, taps, LaTeX, RTL, and selection
Customization Style classes, themes, builders, and callbacks
Streaming Pacing, performance, accessibility, and limitations
Rendering architecture Extension registration, lazy rendering, and performance policies
Inline syntax Autolinks, mentions, channels, and scopes
Custom components Block and inline extensions
GptMarkdown options Every constructor option and default
Benchmarks Methodology, results, and limitations
Migration What each release changes, newest first

Built by Val

gpt_markdown is the open-source rendering foundation of Val, the live visual layer for AI agents.

Building an AI product that needs richer output than a text box? Request early access to Val.

💬 Community

Issues and pull requests are welcome on GitHub. If the package helps your project, consider giving it a like on pub.dev or a star on GitHub.

📄 License

BSD 3-Clause — see LICENSE.

所属分类

依赖

依赖清单 7 项

源码仓库

使用此插件的项目