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

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

The MIME type text/x-rst signals a file that holds reStructuredText content. It is designed for writing formatted text in a plain text file.

This format lets you create documents that are easy to read and edit. Tools can then convert these files into web pages, PDFs, and other formats.

Technical documentation
Project READMEs
Instructional manuals

Files using this MIME type include RST, REST, REST.TXT, RESTX, and RST.TXT.

The format is popular in many programming projects, especially in Python documentation. It emphasizes clarity with simple markup rules.

For more technical details, check the reStructuredText Documentation.

Associated file extensions

.rst, .rest, .rest.txt, .restx, .rst.txt

Usage Examples

HTTP Header

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


    Content-Type: text/x-rst

HTML

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


    <a href="file.dat" type="text/x-rst">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-rst');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.rst, .rest, .rest.txt, .restx, .rst.txt

FAQs

How do I open a file with the text/x-rst MIME type?

Since text/x-rst files are fundamentally plain text, you can open them with any standard text editor like Notepad, Vim, or VS Code. To see the rendered formatting (headers, tables, bold text), you usually need a specialized previewer or an IDE plugin, particularly those designed for Python development.

What is the difference between text/x-rst and text/markdown?

Both are lightweight markup languages, but text/x-rst (reStructuredText) is more feature-rich and extensible, making it the standard for complex technical documentation like Python's official docs. Markdown is generally simpler and more widely supported for basic READMEs and comments.

How do I configure Apache to serve .rst files correctly?

To ensure your Apache server sends the correct header, add the directive AddType text/x-rst .rst to your .htaccess or main configuration file. This tells the server to identify files with the .rst extension as reStructuredText.

Can web browsers render text/x-rst files natively?

No, most modern browsers do not have a built-in engine to render reStructuredText; they will typically display the raw source code as text/plain. To view the document as a web page, it must first be compiled into HTML using tools like Sphinx or Docutils.

What does the "x-" prefix mean in text/x-rst?

The x- prefix signifies that this is a non-standard or experimental subtype not officially registered with the IANA. While it is the de facto standard for reStructuredText, some strict systems might default to text/plain if they are not manually configured to recognize text/x-rst.

How do I set the MIME type for reStructuredText in Nginx?

You should modify your mime.types file, typically located in /etc/nginx/. Add the line text/x-rst rst; inside the types block to ensure that Nginx serves .rst files with the correct Content-Type header.

Is text/x-rst safe to open?

Yes, text/x-rst files contain plain text and are generally safe to open in a text editor. However, if you are using a tool that automatically compiles and executes code snippets embedded within the documentation, you should verify the source of the file first.

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.