Markdown Basics

Core Idea

Markdown is plain text with lightweight structure. It is readable in the terminal and easy to convert into HTML.

Common Syntax

Heading:

# My Page

Paragraph:

This is normal text.

List:

- First point
- Second point

Link:

[Kolam Ayer Makers](https://kolamayermakers.org/)

Inline code:

Run `build-website` after editing.

Fenced code block:

```bash
pwd
ls
```

Source Versus Output

Your source Markdown lives under ~/src/pages. build-website turns it into generated HTML under ~/public_html.

Edit Markdown source. Treat generated HTML as output.

Practice Alone

Create a page with a heading, one paragraph, one link, one list, and one fenced code block. Build it and inspect the public page.

Done When

You can explain which file is source Markdown and which file is generated HTML.

Docs Pointers

• Read CommonMark help.
• Read build website, site source ownership, and HTML on the wire.