Bob's Basic Guide to Markdown

Markdown is a lightweight markup language used to format text. I'm using it right now to write this basic examples of Markdown article.

Let's get started with what you'll learn and showcase some of Markdown's features.

What You'll Learn 🚀

1. Headings and Structure: How to organize content clearly with H1-H6 and sections
2. Core Formatting: How to use bold, italic, lists, quotes, and horizontal rules
3. Links, Images + Code: Add clickable links, embed images, and syntax-highlighted code blocks
4. Tables and List Patterns: Format a table, task lists, and snippets

Scan through and by the end, you'll have a solid Markdown toolkit you can use right away.

Let's jump straight into it. Ready to format like a pro? ✨

Headings

# H1
## H2
### H3
#### H4
##### H5
###### H6

Text Styling

• Italic
• Bold
• Bold Italic
• Strikethrough
• ==Highlight== (if your renderer supports it)
• Underline (requires HTML)

- *Italic*
- **Bold**
- ***Bold Italic***
- ~~Strikethrough~~
- ==Highlight== (if your renderer supports it)
- <u>Underline</u> (requires HTML)

Lists

Unordered List

• Item A
  • Subitem A1
  • Subitem A2
• Item B

- Item A
  - Subitem A1
  - Subitem A2
- Item B

Ordered List

1. First
2. Second
   1. Sub-second
3. Third

1. First
2. Second
   1. Sub-second
3. Third

Links and Images

Link:

Visit OpenAI

[Visit OpenAI](https://openai.com)

Image:

![Pictures Icon](/images/icons/pictures.png)

💡 Tip: Did you notice this is similar to a normal link with anchor text? The ! denotes render the image and your Markdown processor will use the link text as the image alt text for accessibility.

Code

Inline code

Use console.log("Hello, world!") to print a message.

Use `console.log("Hello, world!")` to print a message.

Code Block

function greet(name: string): void {
  console.log(`Hello, ${name}`);
}
greet("Bob");

```ts
function greet(name: string): void {
  console.log(`Hello, ${name}`);
}
greet("Bob");
```

Blockquotes

"Markdown is easy to learn and powerful to use."
— A wise developer

> "Markdown is easy to learn and powerful to use."  
> — A wise developer

Tables

| Feature     | Supported | Notes                   |
|-------------|-----------|--------------------------|
| Headings    | ✅        | H1–H6 levels             |
| Code Blocks | ✅        | With syntax highlighting |
| HTML        | ⚠️        | Depends on renderer      |

Task Lists

• Write an article
• Push to Git
• Tweet about it

- [x] Write an article  
- [ ] Push to Git  
- [ ] Tweet about it

Horizontal Rules

Use three or more dashes or asterisks:

---

Bonus: Tips and More Code Blocks

💡 Tip: Callouts, or alerts.

> 💡 **Tip:** Callouts, or alerts.

Code Block (Bash)

# Create a new folder and initialize Git
mkdir my-project
cd my-project
git init

Add Language to Codeblocks

```bash
# Create a new folder and initialize Git
mkdir my-project
cd my-project
git init
```

Code Block (JSON)

{
"title": "My First Article",
"published": true,
"tags": ["markdown", "guide", "example"]
}

```json
{
"title": "My First Article",
"published": true,
"tags": ["markdown", "guide", "example"]
}
```

And for Markdown? Oh my, use four backticks ````markdown

Thats all folks!

Thank you for reading a Bob's Basics Article. You now know the basics of Markdown.
Use your knowledge wisely, be ethical with your castings and format your content like a pro!