✍️ Markdown Basics ✨ – DEV Community


Have you ever wondered how people write beautiful, well-structured text without using fancy software? The answer is Markdown! πŸ“

Markdown is a lightweight markup language that helps you format text easily. It’s simple to learn and widely used in documentation, blogging, GitHub README files and note-taking apps.

In this quick blog, I’ll take you from newbie to ninja in Markdown. Let’s start! 🎬




πŸ“ Introduction to Markdown

Markdown is a simple and lightweight way to format text. Instead of using complex tools like Microsoft Word, you can format text with symbols and characters. It’s used for writing blogs, notes, documentation and even websites!




πŸ“Œ Why Should You Use Markdown?

Here’s why Markdown is awesome:

βœ… Easy to Learn βž₯ Uses simple symbols for formatting.

βœ… Saves Time βž₯ No need for complicated formatting tools.

βœ… Works Everywhere βž₯ Used in GitHub, Notion, Obsidian, and more.

βœ… Converts to HTML βž₯ You can easily turn Markdown into a website.

Now, let’s learn how to use Markdown! πŸ› οΈ




πŸ”‘ Basic Markdown Syntax

Markdown uses symbols to format text. Let’s see how!



🏷 Headings

Headings are created using the # symbol.

# Heading 1
## Heading 2
### Heading 3
Enter fullscreen mode

Exit fullscreen mode

Output:



Heading 2



Heading 3

πŸ’‘ Use more # symbols for smaller headings!




πŸ”  Bold & Italics

You can make text bold or italic easily.

**This is bold text**
*This is italic text*
Enter fullscreen mode

Exit fullscreen mode

Output:

This is bold text
This is italic text




πŸ“œ Lists



βœ… Unordered List (Bullet Points)

Use -, *, or + for bullet points.

- Apple
- Banana
  - Yellow Banana
  - Green Banana
- Mango
Enter fullscreen mode

Exit fullscreen mode

Output:

  • Apple
  • Banana
    • Yellow Banana
    • Green Banana
  • Mango



πŸ”’ Ordered List (Numbered List)

Just use numbers!

1. First Item
2. Second Item
3. Third Item
Enter fullscreen mode

Exit fullscreen mode

Output:

  1. First Item
  2. Second Item
  3. Third Item



πŸ”— Adding Links

To insert a link, use [text](URL).

[Visit Google](https://www.google.com)
Enter fullscreen mode

Exit fullscreen mode

Output:

Visit Google




πŸ–Ό Adding Images

To insert an image, use ![Alt Text](image_url).

![Markdown Logo](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)
Enter fullscreen mode

Exit fullscreen mode

Output:

Markdown Logo




πŸ’» Code Blocks



Inline Code

Use single backticks for inline code.

This is `inline code`.
Enter fullscreen mode

Exit fullscreen mode

Output:

This is inline code.



Multi-line Code Block

Use triple backticks for larger code blocks.

(triple backticks) print("Hello, World!") (triple backticks)
Enter fullscreen mode

Exit fullscreen mode

Output:

 print("Hello, World!")
Enter fullscreen mode

Exit fullscreen mode




πŸ—¨ Quotes (Blockquotes)

Use > for blockquotes.

> This is a quote.
> Markdown makes writing easy!
Enter fullscreen mode

Exit fullscreen mode

Output:

This is a quote.
Markdown makes writing easy!




βž– Horizontal Line

Use --- or *** to create a separator.

---
Enter fullscreen mode

Exit fullscreen mode



Output:




βœ… Task Lists

You can create checklists using - [ ] for unchecked and - [x] for checked items.

- [x] Completed Task
- [ ] Pending Task
Enter fullscreen mode

Exit fullscreen mode

Output:

  • [x] Completed Task
  • [ ] Pending Task



πŸ”₯ Extended Markdown Syntax

Markdown also has some extra features!



πŸ“Š Creating Tables

Use | and - to create tables.

| Name   | Age | Country  |
|--------|-----|---------|
| Alice  | 25  | USA     |
| Bob    | 30  | Canada  |
Enter fullscreen mode

Exit fullscreen mode

Output:

Name Age Country
Alice 25 USA
Bob 30 Canada



🀩 Emojis

You can add emojis using :emoji_name:.

I love Markdown! πŸŽ‰ :joy:
Enter fullscreen mode

Exit fullscreen mode

Output:

I love Markdown! πŸŽ‰ 😍




πŸ“Œ Footnotes

You can add footnotes using [^1].

This is an example of a footnote.[^1]  

[^1]: This is the footnote text.
Enter fullscreen mode

Exit fullscreen mode

Output:

This is an example of a footnote.1




🎯 Where is Markdown Used?

Markdown is used in many places!
πŸ“Œ GitHub βž₯ Writing README files and documentation.
πŸ“Œ Notion & Obsidian βž₯ Taking structured notes.
πŸ“Œ Jekyll & Hugo βž₯ Writing blogs.
πŸ“Œ Slack & Discord βž₯ Formatting messages.




πŸ† Conclusion

Markdown is super easy to learn and extremely useful! πŸ”‘

Start using it today for:
βœ… Notes
βœ… Blogs
βœ… Documentation
βœ… Websites

With just a few simple symbols, you can format text beautifully!



πŸ–‡οΈ Learning Resources

βž₯ A quick reference to the Markdown syntax

βž₯ Check out my Technical Presentation along with the slide notes for a better understanding πŸŽ₯: πŸ”— View Presentation

πŸ’Ό Let’s connect on LinkedIn! πŸ‘₯πŸ’¬



β™‘ Happy Writing! βœοΈπŸ€— β™‘


  1. This is the footnote text.  ↩



Source link