Write Once, Deliver Personally
MarkdownFlow extends standard Markdown with AI to create personalized, interactive pages. Instead of writing static content for readers, you write prompts for AI agents that transform your instructions into personalized content adapting to each user's choices, preferences, and context.
- 📝 Fully Compatible with Markdown - All standard Markdown syntax works unchanged
- 🤖 AI-Powered Personalization - Write prompts for AI, not content for humans
- 🎯 Simple Extensions - Interactive elements, preserved content, and advanced variables
- 🌍 Multi-Language Support - Built with international audiences in mind
| Resource | Description | Link |
|---|---|---|
| 🌐 Official Website | Project homepage and overview | markdownflow.ai |
| 🎮 Playground | Try MarkdownFlow interactively | play.mdflow.run |
| 📚 Documentation | Complete guides and references | markdownflow.ai/docs |
| Project | Description | Language | License |
|---|---|---|---|
| markdown-flow-ui | Complete UI components with built-in functionality. Ready-to-use React components for interactive markdown documents. | React/TypeScript | MIT |
| remark-flow | React-markdown plugin for MarkdownFlow syntax. Extends react-markdown with variable processing and AI integration. | TypeScript | MIT |
| markdown-it-flow | Markdown-it plugin for MarkdownFlow syntax. Adds MarkdownFlow capabilities to any markdown-it powered application. | TypeScript | MIT |
| Project | Description | Language | License |
|---|---|---|---|
| markdown-flow-agent-py | A Python library to transform MarkdownFlow documents into personalized content. | Python | MIT |
| markdown-flow-agent-go | A Go library to transform MarkdownFlow documents into personalized content. (Coming soon) | Go | MIT |
| Project | Description | License |
|---|---|---|
| markdown-flow | Main documentation, website, and development platform. Interactive demo showcasing MarkdownFlow capabilities. | CC |
MarkdownFlow adds two everyday extensions to standard Markdown, plus variables for advanced shared context:
Buttons and input fields that collect user choices. A single MarkdownFlow document usually does not need variables.
Ask the user about their experience level:
?[Beginner | Intermediate | Expert]
Generate a recommendation based on the experience level the user just selected.
Collect the user's name:
?[...Enter your name here]Text that maintains its exact meaning during AI processing.
Introduce our company values, preserving the exact motto:
===Innovation Through Simplicity===Advanced placeholders for shared context, especially when a value must be supplied by the platform or shared across different MarkdownFlow documents.
Generate a welcoming message for {{user_name}} that mentions their
current account balance of {{balance}} in a friendly tone.For interaction controls, add %{{variable}} only when the answer needs cross-document sharing:
?[%{{shared_level}} Beginner | Intermediate | Expert]- 📚 Education - Personalized learning materials adapting to student levels
- ✍️ Content Creation - Articles adjusting terminology based on reader expertise
- 📰 News Media - Stories expanding from different angles based on interests
- 🎮 Interactive Storytelling - Narratives where choices influence plot direction
- 📖 Read Core Concepts - Understand fundamental principles
- ⚡ 5-Minute Quick Start - Build your first interactive document
- 🎮 Try the Playground - Practice with live examples
- 🚀 Integration Guide - Add to your project
This project is licensed under Creative Commons. Individual components have their own licenses (MIT for most libraries).
Created by AI Shifu, LLC • © 2025
Core Principle: Write prompts for AI, not content for humans