Default components / Links & media

Markdown link

Renders a labeled Markdown link and delegates destination handling to your app.

ATagMdinline componentLinkStylelinkBuilderonLinkTap

What it renders

Live Flutter preview

Starting the Flutter widget

Rendering this component with gpt_markdown…

This is the real GptMarkdown Flutter widget, rendered with the exact Markdown input shown here.

Markdown input

input.md

Read the [package guide](https://pub.dev/packages/gpt_markdown).

Default behavior

Runtime behavior

Balanced parentheses in a URL are supported. The package intentionally does not launch URLs itself.

Accessibility note

Use a descriptive label; wire onLinkTap to an accessible navigation or confirmation flow.

Theming & styling

Theme layering guide

LinkStyle is the component's appearance surface. Set only the values you need; style-sheet values merge field-by-field with the active theme and package defaults.

Style class	Available fields
LinkStyle	color · hoverColor · decoration · decorationThickness · fontWeight

link_style.dart

GptMarkdown(
  markdown,
  styleSheet: const GptMarkdownStyleSheet(
    link: LinkStyle(
      color: Color(0xFF0B57D0),
      decoration: TextDecoration.none,
      fontWeight: FontWeight.w600,
    ),
  ),
  onLinkTap: (url, title) => launchUrlString(url),
)

App-wide or scoped theme

theme.dart

GptMarkdownThemeData(
  brightness: Brightness.light,
  styleSheet: const GptMarkdownStyleSheet(
    link: LinkStyle(
      // Set only the values your app needs.
    ),
  ),
)

Builders & callbacks

linkBuilder

Widget Function(BuildContext context, InlineSpan label, String url, TextStyle style)

Use this only when the default widget structure is no longer the right shape. The resolved style or configuration is passed where applicable.

onLinkTap

void Function(String url, String title)

The callback is intentionally app-owned; add url_launcher in your app if you need external navigation.

Full builder and callback signatures

Safely override the default

A custom component list replaces a default list entirely. Put your matching component first, then append the package defaults so every other Markdown feature continues to render.

keep_defaults.dart

// Passing inlineComponents replaces its defaults. Prepend to override matching syntax,
// then keep every built-in component after it.
GptMarkdown(
  markdown,
  inlineComponents: [
    MyATagMdOverride(),
    ...MarkdownComponent.inlineComponents,
  ],
)

Custom component guide

Related components

Autolink Image Source tag