button Add a features section with icons and descriptions Include a stats section with live data Add a responsive design with modern CSS features
1.4 KiB
Why Mix Formats?
Different content types have different needs:
Markdown – Fast authoring, readable source, perfect for articles and documentation
HTML – Full control over structure, ideal for custom layouts and embedded media
PHP – Dynamic content, server-side logic, database queries, real-time data
By mixing them freely, you get the best of all worlds. Write most content in Markdown for speed, add HTML for custom sections, and use PHP when you need dynamic behavior.
This Page's Structure
This very page demonstrates format mixing:
/examples/mix-formats/
├── 00-intro.md (Markdown introduction)
├── 01-html-example.html (Static HTML component)
├── 02-dynamic.php (Dynamic PHP component)
├── 03-conclusion.md (Markdown conclusion)
└── metadata.ini (Page metadata)
All four content files render seamlessly as one cohesive page. The numbered prefixes ensure they appear in the intended order.
Use Cases
Blog with special sections – Markdown posts with custom HTML callouts or PHP-generated stats
Documentation with demos – Markdown explanations with live PHP examples
Landing pages – Mix markdown content with custom HTML heroes and PHP dynamic elements
Portfolio sites – Markdown project descriptions with HTML galleries and PHP filtering
The flexibility is yours.