Markdown Documentation Style
============================

Apply these rules to all Markdown files generated or rebuilt.

  - **Aligned tables** — columns aligned on `|` separators.
  - **Blank lines before headers** — every header preceded by at least one
    blank line, two for H2, three for H1.  Exception: a header that is the
    first child of a parent header needs only one blank line, provided there
    is no intervening text.
  - **Reference-style links** — use `[title][ref]` with a separate
    `[ref]: url` definition block, not inline `[title](url)`.  References
    should be short (ideally two characters, more only to avoid conflict),
    alphabetical by key, and placed at the very end of the document.
  - **Headers** — setext style for H1/H2; ATX for H3 and beyond, using
    `### symmetric ###` style rather than `### prefix` style.
  - **Line length** — wrap manually at 80 columns, except in code samples,
    ASCII diagrams, and long tables.
  - **Indentation** — indent bullets; indent further for nested bullets.
  - **List spacing** — when any item in a bulleted or numbered list runs
    more than a few lines, separate every item in that list with a blank
    line, not just the long ones.  Short, all-one-line lists stay tight.
