A small Markdown routine for clean structure.
Markdown is a readable way to describe common document structure. A heading begins with hash marks, a list begins with a marker, and emphasis is wrapped in a pair of asterisks or underscores. The exact result depends on the Markdown flavor used by the destination platform.
Start with document structure
Use one top-level heading for the page, then organize related ideas under second- and third-level headings. Headings should describe the section that follows, not merely decorate a sentence.
Lists make sequences visible
Use an unordered list when order does not matter. Use an ordered list for steps, priorities, or a sequence a reader should follow. Keep each item parallel so the reader can scan it easily.
Links need useful labels
Write link text that makes sense without the surrounding sentence. “Read the cleanup guide” is more useful than “click here.” Check every link in the destination preview because different systems handle URLs and attributes differently.
Tables are for comparable values
A table works when each row has the same kind of fields, such as a check and a status. It is not a good substitute for a long paragraph or a complex layout on a narrow screen.
Preview is not validation
A local preview can show whether your markers are in the expected places. It cannot guarantee that the destination platform uses the same parser, allows the same links, or sanitizes the same HTML. Always check the final published result.