.md
)<aside>
⚠️ A word of caution: do not rename the extension of .md
files. If you do, the file type will either not change or the format will become distorted. There is special conversion software available for changing a file from one type to another.
Markdown is a lightweight markup language intended for one purpose: to be used to format text with plain text formatting syntax. Markdown is not a replacement for HTML because its syntax is very small — it contains only a small subset of HTML tags. The reason behind Markdown is to make it easy to read, write, and edit prose.
In other words: HTML is a publishing format, while Markdown is a writing format.
</aside>
Style | Syntax | Example | Output |
---|---|---|---|
Bold | ** ** or __ __ |
**This is bold text** |
This is bold text |
Italic | * * or _ _ |
*This text is italicized* |
This text is italicized |
Strike-through | ~~ ~~ |
~~This was mistaken text~~ |
|
Bold and nested italic | ** ** and _ _ |
**This text is *extremely* important** |
This text is extremely important |
All bold and italic | *** *** |
***All this text is important*** |
All this text is important |
Subscript | <sub> </sub> |
<sub>This is a subscript text</sub> |
|
Superscript | <sup> </sup> |
<sup>This is a superscript text</sup> |
|
Quote | > |
> This is a quoted text |
|
Code | ' ' |
'This is a code text' |
Coded text (red in Notion) |
Code block | `''' |
'''|
'''
This is a code block
'''| | | Link |
Text|
Click for porn| [Click for porn](<https://www.pornhub.com>) | | Lists |
-,
, or
+|
This will look
| | | Task lists |
- [ ]|
- [ ] This is a task list` | |Syntax → [Example text](docs/EXAMPLE.md)
/
will be relative to the repository root./
& ../
Syntax → 
!
preceding it\\
before the Markdown charactertext/plain
is the default value for textual files
application/octet-stream
is the default value for all other cases
Extension | Kind of document | MIME Type |
---|---|---|
.aac |
AAC audio | audio/aac |
.abw |
AbiWord document | application/x-abiword |
.arc |
Archive document (multiple files embedded) | application/x-freearc |
.avif |
AVIF image | image/avif |
.avi |
AVI: Audio Video Interleave | video/x-msvideo |
.azw |
Amazon Kindle eBook format | application/vnd.amazon.ebook |
.bin |
Any kind of binary data | application/octet-stream |
.bmp |
Windows OS/2 Bitmap Graphics | image/bmp |
.bz |
BZip archive | application/x-bzip |
.bz2 |
BZip2 archive | application/x-bzip2 |
.cda |
CD audio | application/x-cdf |
.csh |
C-Shell script | application/x-csh |
.css |
Cascading Style Sheets (CSS) | text/css |
.csv |
Comma-separated values (CSV) | text/csv |
.doc |
Microsoft Word | application/msword |
.docx |
Microsoft Word (OpenXML) | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
.eot |
MS Embedded OpenType fonts | application/vnd.ms-fontobject |
.epub |
Electronic publication (EPUB) | application/epub+zip |
.gz |
GZip Compressed Archive | application/gzip |
.gif |
Graphics Interchange Format (GIF) | image/gif |
.htm , .html |
HyperText Markup Language (HTML) | text/html |
.ico |
Icon format | image/vnd.microsoft.icon |
.ics |
iCalendar format | text/calendar |
.jar |
Java Archive (JAR) | application/java-archive |
.jpeg , .jpg |
JPEG images | image/jpeg |
.js |
JavaScript | text/javascript (Specifications: HTML and RFC 9239) |
.json |
JSON format | application/json |
.jsonld |
JSON-LD format | application/ld+json |
.mid , .midi |
Musical Instrument Digital Interface (MIDI) | audio/midi , audio/x-midi |
.mjs |
JavaScript module | text/javascript |
.mp3 |
MP3 audio | audio/mpeg |
.mp4 |
MP4 video | video/mp4 |
.mpeg |
MPEG Video | video/mpeg |
.mpkg |
Apple Installer Package | application/vnd.apple.installer+xml |
.odp |
OpenDocument presentation document | application/vnd.oasis.opendocument.presentation |
.ods |
OpenDocument spreadsheet document | application/vnd.oasis.opendocument.spreadsheet |
.odt |
OpenDocument text document | application/vnd.oasis.opendocument.text |
.oga |
OGG audio | audio/ogg |
.ogv |
OGG video | video/ogg |
.ogx |
OGG | application/ogg |
.opus |
Opus audio | audio/opus |
.otf |
OpenType font | font/otf |
.png |
Portable Network Graphics | image/png |
.pdf |
Adobe Portable Document Format (PDF) | application/pdf |
.php |
Hypertext Preprocessor (Personal Home Page) | application/x-httpd-php |
.ppt |
Microsoft PowerPoint | application/vnd.ms-powerpoint |
.pptx |
Microsoft PowerPoint (OpenXML) | application/vnd.openxmlformats-officedocument.presentationml.presentation |
.rar |
RAR archive | application/vnd.rar |
.rtf |
Rich Text Format (RTF) | application/rtf |