[docizr-book]
Start Writing In Markdown Beginner
[/docizr-book]
Markdown is a lightweight way to format plain text so it looks good when displayed. You write simple symbols alongside your words — a couple of hash signs for a heading, a blank line to separate paragraphs — and a Markdown tool turns that into a clean, readable page. No special software needed, no menus to learn. Just a text file and a tool that knows how to read it.
This workflow takes you through your first Markdown document step by step, using only headings and paragraphs. That is enough to write a real, well-structured piece of content.
What You Will Need
A tool that shows you Markdown as you type it. Any of the following will work:
- Docizr Editor — an editor built for Markdown, no account or installation required. Open it in your browser and start typing.
- StackEdit — a browser-based editor with a side-by-side preview. Works offline too.
- Dillinger — another browser-based option with a clean two-pane interface.
Open whichever you prefer before moving on.
Workflow
Step 1
Aim: add two headings.
In Markdown, a heading starts with one or more # characters followed by a space and your heading text. One # gives you the largest heading (like the title of a page). Two ## gives you a section heading beneath that.
Type this into your editor:
# My First Markdown Document
## Introduction
Look at the Markdown preview panel — you should see 'My First Markdown Document' appear as a large title, and 'Introduction' appear slightly smaller beneath it.
That is all there is to a heading. The number of # characters controls the level.
Step 2
Aim: add some paragraph text.
A paragraph in Markdown is just text with a blank line above and below it. You do not need any special symbol — just write some words.
Add this below what you typed in step 1:
# My First Markdown Document
## Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write
as much as I like here and it will flow together as a single block of text.
Check the Markdown preview panel. The text appears as a clean paragraph beneath the 'Introduction' heading. Notice that a line break inside the paragraph does not create a new paragraph — only a blank line does that.
Step 3
Aim: add another heading.
Now add another level-two heading and some text under it. This gives your document real structure.
# My First Markdown Document
## Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write
as much as I like here and it will flow together as a single block of text.
## Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means
they work on any device and last forever. I do not need any particular app to open them.
The preview now shows two clearly separated sections, each with its own heading. The document already has the shape of a real article.
My First Markdown Document
Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write as much as I like here and it will flow together as a single block of text.
Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means they work on any device and last forever. I do not need any particular app to open them.
Step 4
Aim: separate ideas by writing more paragraphs
A section can have more than one paragraph. Just leave a blank line between them.
# My First Markdown Document
## Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write
as much as I like here and it will flow together as a single block of text.
## Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means
they work on any device and last forever. I do not need any particular app to open them.
I can use it to write notes, blog posts, documentation, or anything else. Once I know
the basics, I can add more features as I need them.
In the preview, the two blocks of text appear as separate paragraphs with a gap between them. That gap is created entirely by the blank line in your source — no special tag or button required.
My First Markdown Document
Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write as much as I like here and it will flow together as a single block of text.
Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means they work on any device and last forever. I do not need any particular app to open them.
I can use it to write notes, blog posts, documentation, or anything else. Once I know the basics, I can add more features as I need them.
Step 5
Aim: review the completed document.
Take a moment to look at your full preview. You have written a properly structured document using only two Markdown features — headings and paragraphs.
The raw Markdown text is still completely readable even before it is rendered. That is one of Markdown's core strengths: the source and the output both make sense to a human.
Your document so far:
# My First Markdown Document
## Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write
as much as I like here and it will flow together as a single block of text.
## Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means
they work on any device and last forever. I do not need any particular app to open them.
I can use it to write notes, blog posts, documentation, or anything else. Once I know
the basics, I can add more features as I need them.
My First Markdown Document
Introduction
This is my first paragraph written in Markdown. It is just plain text. I can write as much as I like here and it will flow together as a single block of text.
Why I Am Learning Markdown
Markdown is simple to learn and the files it produces are plain text, which means they work on any device and last forever. I do not need any particular app to open them.
I can use it to write notes, blog posts, documentation, or anything else. Once I know the basics, I can add more features as I need them.
When you are comfortable with this, the natural next step is to add emphasis, lists, and links — but there is no rush. Headings and paragraphs alone are enough to write clearly and well.