Create · 7 min read

Markdown and front matter

Prepare a clean source file with metadata, headings, links, images, and code blocks.

Updated August 6, 2026

Formatting guidance

  • Use one H1 title and organize the body with H2 and H3 headings.
  • Use fenced code blocks and include a language when known.
  • Use descriptive link text instead of raw URLs when possible.
  • Give images useful alt text and verify that their URLs are publicly accessible.
  • Keep the canonical URL pointed at the preferred original source.
  • Treat tags as destination suggestions; each platform may enforce its own limits.

Before generation

  • Remove private notes, credentials, placeholders, and unpublished customer information.
  • Check that product names, facts, dates, and links are current.
  • Make the main takeaway explicit rather than expecting the generator to infer it.
  • Preserve important qualifications and citations in the source.