English | 简体中文

🧬 T8: Narrative Text Visualization

T8 is a declarative markdown syntax that can be used to describe the content of data interpretation reports. Technically, based on the assumption that the markdown syntax is generated by the server, the frontend simply consumes the syntax for rendering. As the demand for diversity and immediacy in data representation grows, along with the increasing application of AI and NLP technologies, maintaining text templates on the frontend will become unsustainable. In this context, using T8 for unified rendering will be the optimal choice.

📚 Documentation

• Quick Start - Get started with T8 in minutes with installation and basic usage examples
• Tutorial - Learn about themes, events, plugins, streaming, and LLM integration
• Syntax - Complete T8 syntax reference and structure guide
• API Reference - Detailed API documentation and usage guides

✨ Features

• 🛫 Technology stack agnostic - Can be used into React, Vue, and other frontend stack.
• 🤖 LLM friendly - The T8's syntax is easy to be generated by AI with prompt.
• 🛠️ Extensible - Register custom EntityPhrase to easily customize the T8's ui elements.
• 🪩 Lightweight - Few dependencies, small footprint, before gzip it was less than 20 Kb.

🔨 Installation

Install T8 using npm or yarn:

npm install @antv/t8

yarn add @antv/t8

🚀 Quick Example

import { Text } from '@antv/t8';

const text = new Text({ container: 'container' });
text.theme('light').render(`
  # Sales Report
  Total sales reached [¥1,234,567](metric_value, origin=1234567).
`);

For complete usage examples and advanced features, see the Quick Start Guide.

🤖 Using with LLM

T8 is designed to be LLM-friendly. The T8 syntax can be easily generated by AI models, making it ideal for automated data narrative generation. To help you integrate T8 with AI agents:

• Prompt Templates - Ready-to-use prompts for LLMs to generate T8 syntax
• LLM Integration Guide - Complete guide for using T8 with large language models
• Examples - Sample T8 syntax outputs

📮 Contributing

This project exists thanks to all the people who contribute. And thank you to all our backers! 🙏

• Issues - report bugs or request features
• Discussions - discuss on GitHub

📄 License

MIT@AntV.