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 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.
Why is Markdown so popular?
- Simple and easy to learn: No need to memorize complex HTML tags like
<h1>,<b>,<a href="...">. - Content-focused: Because it’s plain text, you can open and edit
.mdfiles with any text editor (like Notepad, VS Code, Obsidian, etc.) without being distracted by complex formatting tools like those in Microsoft Word. - Industry standard: Markdown is the default language used on GitHub (for
README.mdfiles), 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
4. Links and Images
[Click here to go to Google](https://google.com)

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.