What is MIME type "text/x-markdown"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

text/x-markdown marks files written in Markdown, a lightweight markup language. Markdown uses simple syntax to add formatting to plain text. Instead of heavy HTML tags, you use symbols like asterisks, hashes, and dashes.

Files with this MIME type are common in project documentation and online readme files. They are easily converted to HTML and other formats by many tools. Consider its practical benefits:

Simple syntax: Easy to learn and use.
Conversion-ready: Many utilities transform Markdown into HTML.
Broad support: Editors and platforms routinely render Markdown.

Common file formats include MD, MARKDOWN, MARKDN, and MDOWN.

This MIME type streamlines the writing of formatted documents without complex markup. For more detailed information, visit Wikipedia on Markdown.

Associated file extensions

.md, .markdown, .markdn, .mdown

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/x-markdown

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/x-markdown">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/x-markdown');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.md, .markdown, .markdn, .mdown

FAQs

Is text/x-markdown the official standard MIME type?

No, the official IANA registered type is now text/markdown. The text/x-markdown type includes the x- prefix, indicating it was a non-standard or experimental type used widely before official standardization, and it remains in use for backward compatibility.

How do web browsers display text/x-markdown files?

By default, most browsers display these files as raw plain text, showing the syntax symbols (like **bold** or # Header). To see the document rendered as styled HTML, you typically need a browser extension or the server must convert it to HTML before sending it.

How do I configure Apache to serve .md files as Markdown?

You can add the directive AddType text/x-markdown .md to your .htaccess file or global httpd.conf. This ensures that when a user requests a .md file, Apache sends the correct MIME type header instead of defaulting to text/plain.

What is the correct Nginx configuration for Markdown?

In Nginx, you should edit your mime.types file or the types block in your config. Add the line text/x-markdown md markdown; to associate the MIME type with the .md and .markdown extensions.

Are there security risks with serving Markdown files?

Yes, primarily because standard Markdown allows embedded HTML, which can lead to Cross-Site Scripting (XSS) attacks if user-generated content is rendered unsanitized. When converting Markdown to HTML for the web, always use a parser that sanitizes the output.

Why use text/x-markdown instead of text/plain?

While Markdown is readable as plain text, using the specific MIME type helps applications and editors identify the format. This allows for features like automatic syntax highlighting and triggers Markdown-specific preview modes in compatible tools.

Which file extension is best for this MIME type?

The most widely accepted extension is .md. While text/x-markdown supports variations like markdown, mdown, and markdn, using .md ensures the broadest compatibility with code repositories like GitHub and editors like VS Code.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.