Markdown formatting (.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~~ 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

Relative links

Syntax → [Example text](docs/EXAMPLE.md)

Images

Syntax → ![This is an image](<https://myoctocat.com/assets/images/base-octocat.svg>)

Ignoring Markdown formatting


Common MIMEs (media types)

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