How This Demo Works
Understand the simple pipeline behind this site — and why it is a great fit for publishing learning content.
Leela has finished the whole journey. Now she is curious about something else: "Manjari, how did all these pages get here? Where does this website live?"
Manjari smiles. "A very good question — and the answer is wonderfully simple. Let me show you the whole journey of a single page."
One Content Pipeline
Every page you have read — every lesson, every quiz — travels through the same five-step path before it reaches your screen.
Because the final site is just static files, it needs no server, no database, and no login — and it can be hosted on GitHub Pages at no cost. That is the whole magic trick.
What Is MDX?
MDX is Markdown that can contain React components. Ordinary Markdown gives you headings, lists, and emphasis — and MDX lets you drop in interactive components like quizzes and fact cards right inside the prose.
Compare these two. First, plain Markdown:
**Mars** is the fourth planet from the Sun.
That renders as a sentence. Now MDX — the same sentence, plus a live component:
**Mars** is the fourth planet from the Sun.
<DidYouKnow>
Mars has two tiny moons, Phobos and Deimos.
</DidYouKnow>
The second one becomes a beautiful, styled callout — because MDX lets content authors use the same building blocks the designers build. That is the superpower: content stays easy to write, and the page still feels alive.
On the next page, you will see the same component written in source code — and rendered right below it. Source and result, side by side.
What This Makes Easy
Every page has a history — roll back any change
No fancy editor needed — Markdown is just text
Write a quiz once, use it in any lesson
Changes are reviewed before they go live
GitHub Pages serves the finished site for free
Nothing to patch, no server to keep awake
What This Is Not
Being honest about limits is part of good engineering. This kind of site is not a fit for everything:
This is a static, public content site. It is not an application backend: there is no database, no user accounts, no private content, and no place for secrets or credentials. It cannot run server-side code or handle payments. If a project needs any of those, it needs different infrastructure.
This demo is a public demonstration of how MDX and GitHub Pages can publish learning material — it is not a description of any private production system.
MDX keeps content simple and lets it come alive with components. Docusaurus builds it into static files, and GitHub Pages serves them free from a global CDN. Simple, fast, and version-controlled.