# Markdown

> A simple way to format text with signs like # for titles and ** for bold.

**Field:** Software Development  
**Category:** Files & Formats  
**Also known as:** MD, .md file

## Think of it like

Think of it like writing a note with a few secret signs. A # makes a title, and stars make words bold.

## Definition

Markdown is a simple way to format text using plain signs. A # at the start of a line makes a heading, and **two stars** make text bold. A dash starts a list item. The text stays easy to read as it is, and tools turn it into a neat page. README files, docs and many chat apps use it.

## Example

Emma writes her project's README in Markdown. GitHub shows it as a neat page with a title, a list and bold words.

## Example code

```markdown
# Shop

A small **online shop**.

- Fast
- Free
```

A title, a line with bold words and a short list.

## Why it matters

Most code docs are written in Markdown. It is quick to write and looks good everywhere.

## Common mistake

Forgetting the space after #. Many tools show #Title as plain text instead of a heading.

## Three principles

- **Plain signs.** # for titles, ** for bold.
- **Readable raw.** It looks fine even unformatted.
- **Everywhere.** READMEs, docs and chat apps.

## Related terms

- [Comment](https://learn.benibix.com/term/development/comment)
- [Syntax](https://learn.benibix.com/term/development/syntax)
- [GitHub](https://learn.benibix.com/term/development/github)
- [String](https://learn.benibix.com/term/development/string)
- [Front Matter](https://learn.benibix.com/term/development/front-matter)

## Taught in

- [Markdown and Front Matter](https://learn.benibix.com/learn/development-formats/markdown-and-front-matter): File Formats, 7/11

---

Source: https://learn.benibix.com/term/development/markdown
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
