0e19040473
button Add a features section with icons and descriptions Include a stats section with live data Add a responsive design with modern CSS features
38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
## 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.
|