39 lines
1.4 KiB
Markdown
39 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.
|