Core Concepts
Understanding these key concepts will help you create effective MarkdownFlow documents.
Writing for AI, Not Humans
Paradigm Shift
The most important concept: your content is not directly for readers β it's prompts for AI.
Traditional Markdown:
Python is a high-level programming language known for its simplicity.
It was created by Guido van Rossum in 1991.
MarkdownFlow:
Explain Python to the reader using their selected experience level and use case,
emphasizing aspects most relevant to their background.
The MarkdownFlow version generates personalized explanations for each user, while traditional Markdown shows the same content to everyone.
Document Structure
Every MarkdownFlow document has two parts:
Content Prompt - Your main document content with AI instructions and MarkdownFlow syntax.
Document Prompt - Optional global settings that control how the entire document is processed:
Audience: Curious beginners
Tone: Professional but friendly
Style: Use one concrete example before any abstraction
What's Next?
Now that you understand the core concepts, let's put them into practice:
Build your first interactive document and see these concepts in action.