Skip to content

June 27, 2026 • TechsphereX AI • 2 min read

What is an .md (Markdown) File? A Basic Guide for Beginners

What is an .md (Markdown) File? A Basic Guide for Beginners

What is an .md (Markdown) File?

A file with an .md (or .markdown) extension is a plain text file that uses the Markdown markup language.

Markdown was created by John Gruber in 2004 with a specific goal: to allow users to write text that is easy to read and write (using ordinary characters), which can then be easily converted into valid HTML for web display.

  1. Simple and easy to learn: No need to memorize complex HTML tags like <h1>, <b>, <a href="...">.
  2. Content-focused: Because it’s plain text, you can open and edit .md files with any text editor (like Notepad, VS Code, Obsidian, etc.) without being distracted by complex formatting tools like those in Microsoft Word.
  3. Industry standard: Markdown is the default language used on GitHub (for README.md files), blogging platforms (like Astro, Hugo, Jekyll), and programming forums (like Reddit, StackOverflow).

Basic Markdown Syntax

Here is some of the most basic formatting you will use frequently:

1. Headings

Use the # (hash) character to create headings. The number of #s corresponds to the heading level (from 1 to 6).

# Heading level 1 (largest)
## Heading level 2
### Heading level 3

2. Text Formatting

**Bold**
*Italic*
~~Strikethrough~~

3. Lists

Unordered lists use - or *. Ordered lists use numbers followed by a period.

- Item 1
- Item 2
  - Subitem 2.1

1. Step 1
2. Step 2
[Click here to go to Google](https://google.com)

![Image description](https://link-to-image.jpg)

5. Blockquotes

Use the > character.

> "Stay hungry, stay foolish." - Steve Jobs

Conclusion

Whether you are a software developer, a technical writer, or a blogger, mastering Markdown (knowing how to use .md files) is a mandatory and extremely useful skill that helps optimize your workflow.

Telegram Zalo Facebook Messenger