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

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-asymptote marks plain text files that hold Asymptote code. This language is built for precise vector graphics and technical diagrams. It lets users encode instructions to programmatically generate images.

Files of this type store commands that a compiler reads to draw shapes, diagrams, and graphs. When processed, these commands yield clean and scalable graphics suitable for high-quality documents.
They are text files and can be edited with any simple text editor.

Main use case: Creating technical illustrations, diagrams, and charts for academic and scientific work.
Additional uses: Automating detailed graphic rendering and generating output in formats like PDF and EPS.

The files use the ASY extension. They are typically processed by the Asymptote compiler to convert the code into visual images.
More information is available on the Asymptote website and on the IANA Media Types page.

Associated file extensions

.asy

Usage Examples

HTTP Header

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


    Content-Type: text/x-asymptote

HTML

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


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

Associated file extensions

.asy

FAQs

What is the text/x-asymptote MIME type used for?

The text/x-asymptote MIME type is used to identify source code files for Asymptote, a descriptive vector graphics language. These files, typically ending in .asy, contain C++-like syntax that describes mathematical diagrams and technical illustrations.

How do I open or edit a file with the text/x-asymptote type?

Since these are plain text files, you can open and edit them with any standard text editor such as Notepad, Vim, or Visual Studio Code. To view the resulting graphic, however, you must process the file using the Asymptote compiler.

Can web browsers render text/x-asymptote files?

No, web browsers cannot render the actual graphics defined in these files natively. If a server delivers a file as text/x-asymptote, the browser will likely display the raw source code as plain text. To show the image on a website, you must compile the .asy file into a browser-friendly format like SVG, PDF, or HTML5.

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

To ensure your Apache server sends the correct MIME type, add the following line to your .htaccess file or main configuration: AddType text/x-asymptote .asy. This prevents the browser from misinterpreting the file as a generic binary object.

What does the 'x-' prefix mean in text/x-asymptote?

The x- prefix indicates that this is a non-standard or experimental MIME type that has not been registered with the IANA. It is a convention used for private or community-defined types before they become official standards.

Are there security risks associated with text/x-asymptote files?

Viewing the source code in a text editor is safe. However, because Asymptote is a programming language, compiling and running .asy files from untrusted sources can be risky, as the code executes commands on your system.

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.