Writing and Structure
mdworkspace works best when you treat structure as something you can introduce gradually.
Start with plain markdown
Use markdown for:
- Drafting
- Outlining
- Notes
- Headings
- Lists
- Links
That keeps the source readable and portable from the start.
Use sections to control movement
Sections help when documents become large enough to rearrange:
- Split with
--- - Move related content together
- Duplicate useful blocks
- Collapse parts of the workspace that are not active right now
Keep documents easy to scan
Good habits:
- Short section titles
- Clear heading hierarchy
- One job per section
- Short paragraphs before adding structure
When to add richer blocks
Add richer blocks when the work starts acting like a system:
- Tables for comparisons and tracked data
- Boards for status and flow
- Checklists for operational steps
- Embeds when context needs external media