# Markdown

> A plain text format for writing, where symbols like # and * mark headings, lists, and emphasis. The documentation is written in it.

Source: https://contributors.home-assistant.io/glossary/markdown/

- In code: `.md`, `.markdown`

The pages of home-assistant.io and of this site are Markdown files, and so are descriptions and comments on GitHub. To change a page, you edit its Markdown, often right in the browser. See [Writing docs](https://contributors.home-assistant.io/writing/).

## Related terms

- [YAML](https://contributors.home-assistant.io/glossary/yaml/): A text format for configuration and data, with indentation for structure. Home Assistant uses it for its configuration files, and much more.
- [Pull request](https://contributors.home-assistant.io/glossary/pull-request/): A request on GitHub to merge a change into a repository, where it is reviewed before it goes in.