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

·

4 min read

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!

  1. 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 🙂.

  1. 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**.
  1. 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.
  1. Lists

Two types of list in markdown .

  1. Ordered Lists

  2. 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.

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 😉.

  1. Image

You can also add images in you .md ( markdown ) file .

<!-- this is an example for adding image in markdown -->
![example](image.png)

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.

  1. 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.

  1. 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 🌟