Beginner's Introduction to Markdown: A Simple Guide (Part 1)


Diving into the world of markdown can feel like cracking a secret code, but trust me, it’s far simpler and more exciting than it sounds! Welcome to your beginner's guide to Markdown—a versatile, lightweight markup language used across various platforms, including the popular note-taking software, Obsidian. Whether you're a tech enthusiast, a content creator, or someone just curious about organising your thoughts more efficiently, this guide is here to show you that Markdown is for everyone. And the best part? No prior experience or technical know-how is required. Grab your favourite beverage, sit back, and let's embark on this journey together, making text formatting fun and easy!
Headings
To create a heading, add number signs (#) in front of a word or phrase.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
So, you can create 6 different levels of heading by using #
signs. You can try these examples in markdown editor like obsidian to understand it more 🙂.
Emphasis
You can add emphasis by making text bold or italic.
Italic : emphasis
<!-- you can create italic emphasis with * * with these -->
<!-- you are wondering what are this ? this is syntax for comment in markdown -->
Hi, my name is *zoe*.
So, here in line Hi, my name is zoe
word harry get italic by the use of * *
.
Bold : emphasis
So, here in line Hi, my name is zoe
word harry get Bold by the use of ** **
. For better understanding try it yourself and atleast copy paste these examples in editor to understand them properly 🙂.
<!-- you can create Bold emphasis with ** ** with these -->
<!-- you are wondering what are this ? this is syntax for comment in markdown -->
Hi, my name is **zoe**.
Block-quote
To create a block-quote, add a >
in front of a paragraph.
<!-- you can use this to add quotes or things to remember etc.. -->
> Note : do not forget to practice this.
Nested Block-quote : quotes inside a quote.
> Note : do not forget to practic this.
>
>> please look at Note. zoe's recommendation.
Lists
Two types of list in markdown .
Ordered Lists
Unordered Lists
<!-- Ordered Lists -->
1. first line.
2. second line.
<!-- Unordered Lists -->
first way :
- first line.
- second line.
second way:
* first line.
* second line.
third way:
+ first line.
+ second line.
There are only one way to make ordered list. But there are three different ways to create unordered list.
Links
You can also create links in markdown with [name](full website link)
.
<!-- create links -->
- open [zoe-blogs](https://zoe-blogs.hashnode.dev)
This is how links are created in markdown.
Zoe’s Suggestion : Experiment with all topics you will learn in this guide with each other.
Example :
<!-- you can also use Blockquote in lists -->
1. Example of quotes in list
> this is a quote inside list.
So, this is want i am talking about to do .. Enjoy learning 😉.
Image
You can also add images in you .md ( markdown ) file .
<!-- this is an example for adding image in markdown -->

Note : you have to add image to working directories but in modern editor like obsidian, images can be added with help of options by right clicking on mouse.
Horizontal Line
You can use horizontal line to create separation between sections.
# Horizontal lines
This is just example by Zoe.
## First heading
Content of first heading.
<!-- below are horizontal line to create separation between first headign and second heading -->
---
## Second heading
Content of second heading.
Here, horizontal line create separation between first heading and second heading.
Code Block
You can create code block like use in this guide :
<!-- below is how to create code block -->
```
print("hello_world!")
```
<!-- this is print function in python language -->
<!-- but point to not here is this will not get highlighted in code block -->
```python
print("hello_world!")
```
<!-- here just by adding name of language can create hightlighting -->
Hello there, dear reader!
I'm Zoe, and I want to extend a warm welcome as you embark on this learning journey with us. It's truly exciting to see your interest in diving into new knowledge and skills. Thank you for taking the time to read this guide—I hope you found it helpful and inspiring.
Stay tuned for Part 2, where we'll continue to explore and unravel more fascinating topics. Until then, happy learning, and see you soon!
Warm regards,
Zoe 🌟
Subscribe to my newsletter
Read articles from zoe directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by
