How discovering Markdown Transformed My Learning and Note-taking Journey.
Why I Chose Markdown Over Other Note-Taking Methods?
uring my 🅿️ython learning journey, I initially used Microsoft Word for note-taking, but I found it time-consuming and ineffective.
Notion seemed promising with its creativity, innovation, and AI tools, but I realized I was spending more time on templates and design than on learning Python 🐍.
hile everyone emphasized the importance of note-taking, my existing methods were wasting precious time. I would watch tutorials, take notes, and never revisit them❗Feeling stuck, I shifted to solely watching tutorials, until I encountered a breakthrough.
ecently, during my Git learning on DataCamp, I faced a dilemma – I wasn’t taking notes. The README.md file in my Git repository caught my attention. An idea struck: use GitHub as a notebook and Markdown as the note-taking tool. And so, my first note,“Introduction to Git”, was born, accessible HERE.
ARKDOWN⬇️has empowered me to create organized notes and actively learn Git. Now, I’m immersed in the practical application of Markdown, simultaneously learning and documenting my progress…
🚶🏼Let’s start the journey🧳
What is Markdown?
Ⓜ️🅰️RKD🅾️WN is a sweet and suitable way to write content for the web🕸️.
It is a 🪶lightweight markup language with plain-text formatting syntax.
It uses symbols like #, *, _, >, and ! to format text, create headings, lists, paragraphs, and more.
Markdown is ideal for web content, documentation, and note-taking due to its simplicity and readability.
Table of Contents: {#top}
Ⓜ️arkdown ©️heat Sheet
💡Before starting, open a Markdown Editor; copy or write each syntax there to see the magic 🪄
1. 
eaders
1
2
3
4
5
6
# First Level Header
## Second Level Header
### Third Level Header
#### Fourth Level Header
##### Fifth Level Header
###### Sixth Level Header
🟰➖Alternate Syntax for H1 & H2:
1
2
3
4
5
First Level Header
==================
Second Level Header
-------------------
Tip:
- Put blank lines before and after a heading.
- Add a space between
#and the heading text.- Use headings for hierarchy, not just for styling.
2. Text formatting
| Format | Syntax | Output |
|---|---|---|
| Bold | **text** or __text__ | Bold Text |
| Italic | *text* or _text_ | Italic Text |
| Bold & Italic | ***text*** or ___text___ | Bold and Italic |
~~text~~ | ||
| Highlighted | ==Highlight== | ==Highlight== |
| Subscript | <sub>text</sub> | Subscript |
| Superscript | <sup>text</sup> | Superscript |
3. 
Paragraphs & Line Breaks
Use 2️⃣SPACEs(☄️☄️) at the end of a line to insert a line break. Press ENTER to start a new paragraph.
1
2
3
4
This is the first line.☄️☄️
This is the second line.☄️☄️
This is a new paragraph.☄️☄️
4. 
Blockquote
❇️Blockquotes are created using the > symbol.
1
2
3
4
> This is a blockquote.
>
> - You can include multiple lines.
> - Even lists inside!
❇️Nested Blockquotes:
1
2
3
> This is an outer blockquote.
>> This is an inner blockquote.
>>> You can go deeper.
5.Horizontal Lines
Use 3️⃣three or more asterisks (***), dashes(---), or underscores(___):
1
2
3
***
---
___
6.Code Blocks
💠Inline code
✅To make codes visible as they are, we wrap the them in 2️⃣ backticks `<br> `
💠Code Blocks
✅To create Code Blocks, use 3️⃣ backticks(```) or tilde(~~~)before and after the code snippet, and provide the language name after initial backtics, in order to Highlight the code syntax.
1
2
3
```html
Code Block goes here...
```
7.🔗Links:
🖇️Inline link:
1
[MY GitHub](https://github.com "GitHub Homepage")
🖇️Reference link:
1
2
3
[My Linkedin] [ refrence-to-link ]
[ refrence-to-link ]: https://www.linkedin.com/in/pirikli/ "Pirikli"
🖇️Direct Link:
1
<[email protected]>{:target="_blank"}
💡Tip: We add the{:target="_blank"}immediately after the link, in order to open the link in new tab.
8. 🖼️Images:
📷Inline Image:
1
📷Reference Image:
1
2
3
![Alt text][image]
[image]: image-url.jpg "Image Title"
9. 📃Lists
🔢Ordered list
1
2
3
1. This is the first item of this ordered list.
2. This is the second item.
3. The third item.
⏹️Unordered list:
1
2
3
* This is the first item of this unordered list.
* This is the second one.
* and son on...
🪺Nested lists(indentation in lists):
✅Use TAB to indent nested lists
1
2
3
4
5
6
7
8
9
10
1. The first item with inner list:
- first inner
- second inner
2. The second item with nested list
* first inner
* second inner
- one
- two
* A
* B
Task Lists:
1
2
3
4
- [ ] Wake Up
- [ ] Get Up
- [ ] Wash Up
- [ ] Rush Up
10. Scaping Characters:
To display Markdown symbols as plain text, use a backslash (\).
1
\*This text is not italicized\*
Here is the list of other characters to scape.
11. 
Tables
1
2
3
4
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1 | Data 2 | Data 3 |
| Data 4 | Data 5 | Data 6 |
12. Heading IDs
I think of it as “Inner Link” or “IN Page Link”.
I usually use it to create “Content Table” and “🦘Jump Up High”.
1
2
3
4
[Here is the Link to that Heading](#headid5)
##### This is a heading we want to refer or link to {#headid5}
13. Footnotes
1
2
3
This is a sentence with a footnote.[^1]
[^1]: This is the footnote text.
14. Best Markdown Editors: Why Obsidian Stands Out
Markdown editors enhance note-taking, documentation, and web writing by providing a distraction-free environment with instant formatting. Here are some top choices:
✅ Obsidian – A powerful, local-first Markdown editor with backlinks, graph views, and plugins for knowledge management. Ideal for writers, researchers, and programmers.
✅ VS Code – A robust code editor with Markdown preview and extensions.
✅ Typora – A clean, minimalist editor with real-time rendering.
✅ StackEdit – A browser-based Markdown editor with cloud sync.
🔹 Why Choose Obsidian?
Obsidian isn’t just a Markdown editor—it’s a second brain for creatives. With its bi-directional linking, tags, and plugins, it transforms raw notes into a structured knowledge hub.
15. Conclusion
Switching to Markdown has revolutionized my learning experience. It allows me to take structured notes, integrate them with GitHub, and focus on learning instead of formatting. Whether you’re documenting your programming journey or writing blog posts, Markdown is a game-changer!
🔗 Start your Markdown journey today! ➕Share your experience below in comments: ➖Which Markdown Editor do you use and why? ➖Do you prefer other writing tools over Markdown? why? ➖🟣🟣🟣