Writing in Markdown

8 min

All Hatch course content is authored in Markdown. This keeps your content portable, version-controllable, and easy to write.

Basics

Use headings to structure your lesson:

# Main Title
## Section
### Subsection

Formatting

  • Bold text with **double asterisks**
  • Italic text with *single asterisks*
  • Inline code with backticks
  • Links with [text](url)

Code Blocks

Use fenced code blocks with a language identifier for syntax highlighting:

function greet(name) {
  return `Hello, ${name}! Welcome to Hatch.`;
}

Lists

Both ordered and unordered lists work as expected:

  1. First item
  2. Second item
  3. Third item

Tips

Use blockquotes to call out important information or tips for your learners.