What is the suggested mime type and file extension?

[toastal]

If I were to keep Mermaid graphs in a separate file and include them, what file extension would that me? If I were to serve that file from a web server, what is the mime type?

I did not find anything about this in the docs.

[theanurin]

+1

[h0lg]

I'm suggesting file extension .mmd and MIME type text/mmd.

[bollwyvl]

Not to flog this too much, but it really would be helpful for broader, consistent adoption of mermaid by downstreams. While going through the full IANA process is... a lot, just having a note on the main documentation website would be sufficient for moving forward. Perhaps a concrete PR to the docs would be the most effective way forward.

I'm suggesting file extension .mmd

This is a fine, and is generally used both in this repo and in the wild. .mmd is already registered for a karaoke config file, but the chances of collision seem small.

MIME type text/mmd

This may be a bit too terse. Perhaps something more searchable would be useful if one found a random file-on-the-wire:

• text/mermaid
• text/mermaid-js

Or, with the vnd. prefix, as the venerable graphviz is registered:

• text/vnd.mermaid
• text/vnd.mermaid-js

Another path altogether, as mermaid does (optionally) embed a modified subset of markdown, might be to consider documenting a markdown variant string, which has a separate registry, and also requires the charset:

• text/markdown; charset=UTF-8; variant=MermaidJS

However, this is unattractive, as basically no other markdown engine would work with such a document outside of the widely-used fenced code block syntax, or one of the less-supported syntaxes.

[bollwyvl]

Opened #4485