# Markdown

> A way to format text with plain symbols like # and *, readable even before it is rendered.

- Level: Basic
- Topics: Software
- URL: https://tidbit.legios.com.ar/markdown/
- In Spanish: [Markdown](https://tidbit.legios.com.ar/es/markdown/)

**Markdown** is a simple set of conventions for writing formatted text with an ordinary keyboard. A line that starts with `#` becomes a heading, a word between `**` becomes bold, lines starting with `-` become a bulleted list, and `[text](https://example.com)` becomes a link. A program then turns those symbols into a nicely formatted page, usually HTML.

John Gruber and Aaron Swartz created it in 2004 with one goal: the raw text should look fine on its own, like a well-written email, so you never need a preview to understand it. That is why it spread everywhere: README files on GitHub (`README.md`), notes apps like Obsidian, chat apps like Slack and Discord, documentation sites, and the answers chatbots like Claude or ChatGPT write, which come out in Markdown and get rendered on screen.

Because the original description left some cases ambiguous, there are several dialects. **CommonMark** is a precise specification that most tools now follow, and **GitHub Flavored Markdown** adds tables, checklists and strikethrough on top. Since it is plain text, a Markdown file opens in any editor, works well with git, and will still be readable decades from now.

## An analogy

Handwritten proofreading marks. A line under a word means "make it bold", a star at the start means "bullet point". Anyone can read the draft as it is, and a typesetter knows exactly how to print it.

## Keep in mind

- Formatting with plain symbols: # for headings, ** for bold, - for lists.
- The raw text is meant to be readable without rendering it.
- Files usually end in `.md`; GitHub shows `README.md` on every project page.
- CommonMark is the precise spec; GitHub Flavored Markdown adds tables and checklists.

## Go deeper

- [Markdown on Wikipedia](https://en.wikipedia.org/wiki/Markdown)
- [CommonMark: spec and 10-minute tutorial](https://commonmark.org/)
- [Markdown Guide](https://www.markdownguide.org/)

## Related terms

- [HTML](https://tidbit.legios.com.ar/html/): The text format that describes what is on a web page: headings, paragraphs, links.
- [GitHub](https://tidbit.legios.com.ar/github/): A website where teams store their code with Git and work on it together.
- [Slack](https://tidbit.legios.com.ar/slack/): A chat app for work, organized in channels instead of endless email threads.
- [Discord](https://tidbit.legios.com.ar/discord/): An app for online communities to chat by text, voice and video in shared spaces.
- [Chatbot](https://tidbit.legios.com.ar/chatbot/): A program you talk to by typing or speaking, as if it were a person.
- [Claude](https://tidbit.legios.com.ar/claude/): Anthropic's family of AI models, and the assistant app built on them.
- [ChatGPT](https://tidbit.legios.com.ar/chatgpt/): OpenAI's chat assistant, the app that brought AI chatbots to the general public.
- [Git](https://tidbit.legios.com.ar/git/): A time machine for code: every change saved, by whom and why.