Textf #

Markdown-like text styling for inline text — fully compatible with Flutter's Text widget.

What Textf Is #

✅ Inline text formatting only ✅ Works like Text, but supports inline styles ✅ Ideal for i18n / ARB / JSON localized strings ✅ Zero dependencies, minimal footprint

From Text to Textf #

Replace Text with Textf to add simple formatting:

Textf('Hello **Flutter**. Build for ==any screen==!');

⚠️ Important: Textf is designed for inline styling only and is not a full Markdown renderer. It doesn't support block elements like lists, headings, or images.

Installation #

Add Textf to your pubspec.yaml:

dependencies:
  textf: ^1.1.0

Then run:

flutter pub get

Getting Started #

import 'package:textf/textf.dart';

class MyWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Textf(
      'Hello **bold** *italic* ~~strikethrough~~ `code` '
      '++underline++ ==highlight== ^super^ ~sub~ '
      '[Flutter](https://flutter.dev)',
      style: TextStyle(fontSize: 16),
    );
  }
}

Supported Formatting #

Escaping Characters #

Use backslash to display literal formatting characters:

Textf(r'Use \*asterisks\* without formatting');
// Output: Use *asterisks* without formatting

Textf(r'Show a placeholder: \{key}');
// Output: Show a placeholder: {key}

Escapable characters: *, _, ~, `, [, ], (, ), {, }, \

🆕 Widget Placeholders #

Insert any InlineSpan (such as WidgetSpan or TextSpan) using named placeholders:

Textf(
  'Built with {flutter} and {dart}. Made with {love}.',
  placeholders: {
    'flutter': WidgetSpan(child: Image.asset('flutter.png', width: 16)),
    'dart': WidgetSpan(child: Image.asset('dart.png', width: 16)),
    'love': WidgetSpan(child: Icon(Icons.favorite, color: Colors.red, size: 16)),
  },
)

Key points:

• Keys must be alphanumeric or underscores: {icon}, {my_image}, {step1}
• Missing keys render as literal text (e.g., {missing}) — no crashes
• Works inside formatting: **{icon}** and links: [Click {icon}](url)
• Escape with backslash: \{key} renders as {key}

Customization with TextfOptions #

Wrap your widgets with TextfOptions to customize formatting styles:

TextfOptions(
  // Style overrides
  boldStyle: TextStyle(fontWeight: FontWeight.w900, color: Colors.orange),
  italicStyle: TextStyle(fontStyle: FontStyle.italic, color: Colors.purple),
  codeStyle: TextStyle(fontFamily: 'JetBrains Mono', backgroundColor: Colors.grey.shade200),

  // Link behavior
  linkStyle: TextStyle(color: Colors.teal, decoration: TextDecoration.none),
  linkHoverStyle: TextStyle(color: Colors.teal, decoration: TextDecoration.underline),
  onLinkTap: (url, displayText) => launchUrl(Uri.parse(url)),
  onLinkHover: (url, displayText, {required isHovering}) => debugPrint('Hover: $isHovering'),

  child: Textf('**Bold** *italic* `code` [link](https://example.com)'),
)

Available Style Options #

Link Options #

Script Options #

Inheritance #

TextfOptions inherits through the widget tree. Styles are merged — a parent's color combines with a child's font weight:

TextfOptions(
  boldStyle: TextStyle(color: Colors.red),  // Parent: red color
  child: TextfOptions(
    boldStyle: TextStyle(fontWeight: FontWeight.w900),  // Child: heavy weight
    child: Textf('**This is red AND heavy**'),
  ),
)

SelectionArea Support #

Textf works with Flutter's SelectionArea for text selection:

SelectionArea(
  child: Textf('Select **this** text!'),
)

Note: Due to links being rendered as WidgetSpan elements, text selection cannot span across interactive links. This is a Flutter limitation, not a Textf bug.

Performance #

Textf is designed for performance:

• O(N) Linear Parsing — Single-pass tokenization scales linearly with text length
• Smart Caching — Parsed results are cached and reused across rebuilds
• Intelligent Invalidation — Cache only clears when text, style, theme, or options actually change
• Memory Efficient — LRU cache with configurable limits prevents memory bloat

Cache Management #

For advanced use cases, you can manually clear the global parse cache:

// Clear all cached parse results
Textf.clearCache();

This is rarely needed — the cache automatically manages itself using LRU eviction.

Accessibility #

Textf respects Flutter's accessibility standards:

1. Text Scaling — Fully respects MediaQuery.textScalerOf(context) and system accessibility settings
2. Screen Readers — Links are wrapped in Semantics widgets with link: true for TalkBack/VoiceOver
3. RTL Support — Bidirectional text and RTL languages work correctly

Why Textf? #

About the Name #

The name "Textf" is inspired by C's printf (print formatted). Similarly, Textf (Text formatted) provides simple, efficient text formatting for Flutter.

Features #

• ✅ Bold, Italic, Bold+Italic
• ✅ Strikethrough, Underline, Highlight
• ✅ Inline Code with theme-aware styling
• ✅ Superscript and Subscript
• ✅ Links with hover effects and callbacks
• ✅ Widget Placeholders via {key} syntax
• ✅ Nested formatting (up to 2 levels)
• ✅ Customizable styles via TextfOptions
• ✅ Theme-aware defaults
• ✅ RTL language support
• ✅ Smart caching for performance
• ✅ Full Text widget API compatibility

Limitations #

When to Use Textf #

✅ Use Textf for:

• Chat messages and comments
• UI labels and captions
• Internationalized strings with formatting
• Performance-critical text rendering
• Simple inline formatting needs

❌ Don't use Textf for:

• Full Markdown documents
• HTML rendering
• Content with headings, lists, or tables
• Documents requiring text selection across links

API Reference #

See the full API documentation on pub.dev.

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License — see the LICENSE file for details.