Markdown Tutorial for Beginners: Basic Syntax With Examples

Markdown is a simple way to write formatted text without fighting with toolbars. You type plain text, add a few small symbols, and your writing becomes structured: headings, lists, links, images, tables, code blocks, and more.

This Markdown tutorial is written for beginners. If you have never used Markdown before, start here. If you already know the basics, you can use this page as a Markdown cheat sheet.

Glifaro supports standard Markdown plus extra syntax for modern writing, including task lists, tables, Mermaid diagrams, math, callouts, media embeds, and more.

[!TIP] The core idea Markdown is not a programming language. It is just a clean writing format that helps you structure text quickly.

---

1. What Is Markdown?

Markdown is a plain-text writing format. Instead of clicking buttons to make text bold or create a heading, you type small markers directly in the text.

For example:

# This is a heading

This is a paragraph with **bold text** and a [link](https://glifaro.com).

When rendered, it becomes a clean document with a heading, bold text, and a clickable link.

Markdown is popular because it is:

• Easy to read before rendering
• Fast to write
• Portable across editors
• Great for technical documentation
• Useful for notes, blogs, README files, and product docs

2. Markdown Cheat Sheet

Here is a quick Markdown syntax cheat sheet:

Use this table when you forget the basic Markdown syntax.

---

3. Headings

Headings help readers understand the structure of your document. Markdown supports six heading levels.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Use # for the main title, ## for major sections, and ### for smaller sections.

Good heading habits

• Use only one # Heading 1 for the main title.
• Use headings in order.
• Do not use headings only to make text bigger.
• Keep headings short and clear.

4. Paragraphs And Line Breaks

A paragraph is just normal text separated by a blank line.

This is the first paragraph.

This is the second paragraph.

If you want a line break inside the same paragraph, add two spaces at the end of a line:

First line.  
Second line.

In Glifaro, paragraphs and headings are spaced automatically so your document stays readable.

5. Bold, Italic, And Strikethrough

Use emphasis when you want to guide attention.

**Bold text**
_Italic text_
***Bold and italic text***
~~Strikethrough text~~

Rendered example:

Bold text is useful for important words.
Italic text is useful for soft emphasis.
Bold and italic text is useful when something really matters.
Strikethrough text is useful for old or removed ideas.

Do not overuse emphasis. If everything is bold, nothing is important.

6. Links

Links use square brackets for the label and parentheses for the URL.

[Visit Glifaro](https://glifaro.com)

Rendered example: Visit Glifaro

You can also link to a tutorial page:

[Read the Glifaro guide](https://glifaro.com/docs/getting-started)

Good link labels explain where the reader will go. Avoid labels like "click here" when possible.

7. Images

Images are similar to links, but they start with an exclamation mark.

![A short image description](https://picsum.photos/1200/640)

Rendered example:

The text inside [] is called alt text. It helps readers understand the image and helps search engines understand the page.

In Glifaro, you can also paste or drag images directly into the editor.

8. Lists

Use unordered lists when order does not matter.

- Write the outline
- Add examples
- Review the final draft

Rendered example:

• Write the outline
• Add examples
• Review the final draft

Use ordered lists when order matters.

1. Open Glifaro
2. Create a new file
3. Start writing Markdown

Rendered example:

1. Open Glifaro
2. Create a new file
3. Start writing Markdown

9. Task Lists

Task lists are useful for checklists, project plans, and writing workflows.

- [x] Draft the document
- [x] Add examples
- [ ] Review before publishing

Rendered example:

• Draft the document
• Add examples
• Review before publishing

Task lists are one of the easiest ways to turn a Markdown document into a practical plan.

10. Blockquotes

Use blockquotes for notes, quotes, warnings, or important ideas.

> A good document makes the next step easier.

Rendered example:

A good document makes the next step easier.

In Glifaro, you can also write callouts:

> [!NOTE] Remember
> Markdown is best when the structure is simple.

Rendered example:

[!NOTE] Remember Markdown is best when the structure is simple.

11. Inline Code And Code Blocks

Use inline code for commands, filenames, package names, or short technical terms.

Run `npm install` before starting the app.

Rendered example:

Run npm install before starting the app.

Use fenced code blocks for longer code examples.

​```ts
function greet(name: string) {
  return `Hello, ${name}`;
}
```

Rendered example:

​```ts function greet(name: string) { return Hello, ${name}; }

Glifaro uses syntax highlighting for code blocks, which makes technical documents easier to read.

## 12. Tables

Tables are useful for comparisons, plans, and structured information.

```md
| Feature | Use case | Example |
| --- | --- | --- |
| Headings | Structure | `## Overview` |
| Links | References | `[Docs](https://glifaro.com)` |
| Tasks | Planning | `- [ ] Review` |

Rendered example:

You do not need to make table columns perfectly aligned. A good Markdown editor can still render the table.

13. Horizontal Rules

Use a horizontal rule to separate major parts of a document.

---

Rendered example:

---

Use horizontal rules sparingly. Headings are usually better for structure.

14. Basic Markdown Document Template

Here is a simple Markdown template you can copy:

# Project Note Title

## Summary

Write the main idea in one or two paragraphs.

## Details

- Key point one
- Key point two
- Key point three

## Tasks

- [ ] First task
- [ ] Second task

## References

- [Glifaro](https://glifaro.com)

This is enough for most notes, plans, and short documents.

---

15. Extra Markdown Syntax In Glifaro

Once you understand basic Markdown syntax, Glifaro gives you more tools for complex writing.

Mermaid diagrams

Use Mermaid when you need flowcharts or process diagrams.

​```mermaid
flowchart LR
  A[Idea] --> B[Draft]
  B --> C[Review]
  C --> D[Publish]
```

Rendered example:

​```mermaid flowchart LR A[Idea] --> B[Draft] B --> C[Review] C --> D[Publish]

### Math

Use inline math for short formulas like $E = mc^2$.

Use block math for larger formulas:

```md
$$
score = clarity \times structure
$$

Rendered example:

$$ score = clarity \times structure $$

Footnotes

Footnotes add extra context without interrupting the main text.[^markdown-footnote]

This sentence has a footnote.[^note]

[^note]: This is the footnote content.

HTML details

Use collapsible sections when extra information is useful but not always needed.

<details>
  <summary>More details</summary>
  <p>This content is hidden until the reader opens it.</p>
</details>

Rendered example:

More details This content is hidden until the reader opens it.

16. Common Markdown Mistakes

Mistake 1: Forgetting the blank line

If a list, heading, or table does not render correctly, add a blank line before it.

Mistake 2: Using headings only for size

Headings create structure. If you only want emphasis, use bold text instead.

Mistake 3: Writing unclear link text

This is weak:

[click here](https://glifaro.com)

This is better:

[Download Glifaro](https://glifaro.com)

Mistake 4: Missing alt text for images

This is weak:

![](screenshot.png)

This is better:

![Glifaro workspace screenshot](screenshot.png)

17. Practice: Write Your First Markdown Page

Try writing this in Glifaro:

# My First Markdown Note

Today I learned the basic Markdown syntax.

## What I learned

- Headings
- Lists
- Links
- Images
- Code blocks
- Tables

## Next steps

- [x] Write a note
- [ ] Add an image
- [ ] Share it with someone

If this renders correctly, you already know enough Markdown to write useful documents.

Final Thoughts

Markdown is popular because it is simple. You can learn the basics in a few minutes, but it can still grow with you as your documents become more complex.

Glifaro keeps that simplicity and adds a modern writing experience: fast startup, clean typography, project-based file management, image paste and drag-and-drop, Mermaid diagrams, math, code highlighting, and local AI Agent workflows.

If you want a lightweight Markdown editor for everyday writing, technical documentation, research notes, product specs, or AI-assisted drafts, Glifaro is a practical place to start.

[^markdown-footnote]: A footnote is a note placed at the bottom of the document. It is useful for sources, definitions, and side comments.