All articles

Bob's Basic Guide to Markdown

A Quick and Practical Guide to Markdown Syntax You Can Use Right Now

Bob's Basic Guide to Markdown
Bob⚡James
· 3 min read

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

Let's get started with the basic examples of Markdown to showcase some of Markdown's features.


Table of Contents

  1. Headings
  2. Text Styling
  3. Lists
  4. Links and Images
  5. Code
  6. Blockquotes
  7. Tables
  8. Task Lists
  9. Horizontal Rules
  10. HTML in Markdown
  11. Bonus: Tips and More Code Blocks

Headings

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

Text Styling

  • Italic
  • Bold
  • Bold Italic
  • Strikethrough
  • ==Highlight== (if your renderer supports it)
  • Underline (requires HTML)
Markdown
- *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
Markdown
- Item A
  - Subitem A1
  - Subitem A2
- Item B

Ordered List

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

Visit OpenAI

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

Image:

Markdown Logo

Markdown
![Markdown Logo](https://markdown-here.com/img/icon256.png)

Code

Inline code

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

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

Code Block

TypeScript
function greet(name: string): void {
  console.log(`Hello, ${name}`);
}
greet("Bob");
Markdown
```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
> "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
Markdown
| 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
Markdown
- [x] Write an article  
- [ ] Push to Git  
- [ ] Tweet about it

Horizontal Rules

Use three or more dashes or asterisks:


Markdown
---

Bonus: Tips and More Code Blocks

💡 Tip: Callouts, or alerts.

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

Code Block (Bash)

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

Add Language to Codeblocks

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

Code Block (JSON)

JSON
{
"title": "My First Article",
"published": true,
"tags": ["markdown", "guide", "example"]
}
Markdown
```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!

Comments

Please sign in to leave a comment.

Bob⚡James11 days ago

test comment ty for reading 🙏

HE
hello bossses210 days ago

checking notifications