Default components / Lists & controls

Unordered list

Renders dash or asterisk list items with the package bullet and spacing rules.

UnOrderedListblock componentListStyleunOrderedListBuilder

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
1- Focus on the answer 2- Keep the source link 3- Preserve context

Default behavior

Runtime behavior

Each list item renders its own Markdown child, so inline syntax still works inside the item.

Accessibility note

Use a list for peer items rather than inserting manual bullet characters into prose.

Theming & styling

Theme layering guide

ListStyle 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 classAvailable fields
ListStylebulletSize · bulletColor · bulletShape · markerTextStyle · indent · gapAfterMarker
unordered-list_style.dart
1GptMarkdown( 2 markdown, 3 styleSheet: const GptMarkdownStyleSheet( 4 list: ListStyle( 5 bulletColor: Colors.indigo, 6 bulletSize: 5, 7 indent: 12, 8 gapAfterMarker: 12, 9 ), 10 ), 11)

App-wide or scoped theme

theme.dart
1GptMarkdownThemeData( 2 brightness: Brightness.light, 3 styleSheet: const GptMarkdownStyleSheet( 4 list: ListStyle( 5 // Set only the values your app needs. 6 ), 7 ), 8)

Builders & callbacks

unOrderedListBuilder

Widget Function(BuildContext context, Widget child, GptMarkdownConfig config)

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

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
1// Passing components replaces its defaults. Prepend to override matching syntax, 2// then keep every built-in component after it. 3GptMarkdown( 4 markdown, 5 components: [ 6 MyUnOrderedListOverride(), 7 ...MarkdownComponent.globalComponents, 8 ], 9)
Custom component guide

Related components