Skip to content

Djot to Muse Converter

FileFlip converts Djot to Muse entirely inside your browser, using Pandoc compiled to WebAssembly. The file is never uploaded to a server: it is read off your disk, converted on your own machine, and saved back by the browser. That means no file-size limit, no queue and no account.

Convert DJ to

How do I convert a Djot file to Muse?#

  1. Drop your Djot file onto the converter at the top of this page, or click it to pick one from your computer. You can add as many as you like.
  2. Leave the target set to Muse and the conversion starts on its own. FileFlip downloads 65.8 MB of WebAssembly the first time and nothing after that, then runs Pandoc on your own machine.
  3. Save the Muse file. Your browser writes it straight to your downloads folder, because there was never a server holding it.

Does converting Djot to Muse lose quality?#

Not in the sense of pixels or samples. Converting Djot to Muse rebuilds the file in Muse's own model rather than re-encoding it, so everything Muse can represent comes through exactly and anything it cannot has to be dropped. Expect the words to come through exactly and the page breaks to move.

Is it safe to convert Djot files online?#

Yes, because nothing is uploaded. FileFlip converts Djot files inside the browser tab you already have open, using WebAssembly builds of the same engines a desktop converter would install. Your file is read from your own disk into the page's memory, and no request carrying it is ever made.

You do not have to take that on trust. Open your browser's network panel, run a conversion, and you will see the engine come down and your file go nowhere. There is no upload, no server-side copy, no retention window, and no account tied to what you converted.

How FileFlip works lists every engine, its version and its download size, and shows how to check for yourself that nothing leaves your machine.

What Djot to Muse actually does to the file#

Converting Djot to Muse runs on Pandoc, downloads 65.8 MB of WebAssembly the first time and nothing after that, rebuilds the file in the target's own model, keeps selectable text and page layout.

EnginePandoc
Conversion pathOne step: Djot → Muse
Downloaded to your browser65.8 MB, once, then cached by your browser
QualityRebuilt in the target's model
You get backOne file
Where it runsIn a background worker, so the page stays responsive

What survives the conversion

What is in the fileThis conversionWhy
Selectable textKeptCarried through into the converted file.
Page layoutKeptCarried through into the converted file.

What is a Djot file?#

A DJ file holds a Djot document, a lightweight markup that reads like Markdown but is built on an unambiguous grammar, so it parses the same way in every implementation.

Write in Djot when Markdown's readability is wanted without its parsing ambiguities, and broad tool support isn't a requirement yet.

Convert Djot to another format when sharing with tools or people that only handle Markdown, HTML, or another mainstream format.

What is a Muse file?#

A MUSE file holds Emacs Muse markup, the plain-text syntax of an Emacs authoring mode that publishes a single source file to HTML, LaTeX, and other output formats.

Write in Muse when authoring inside Emacs and publishing the same document to more than one output format from a single source.

Convert Muse markup to another format when the document needs to leave Emacs, since almost nothing else reads it directly.

Djot to Muse questions people ask#

What is a .dj file?

A .dj file is a Djot document, a lightweight markup language that looks like Markdown but parses under a stricter, unambiguous grammar. It was designed in 2022 by John MacFarlane, who also created Pandoc and co-authored the CommonMark specification.

Who created Djot and why?

Djot was created by John MacFarlane, drawing on his essay 'Beyond Markdown' about the parsing problems built into Markdown and CommonMark. Djot keeps Markdown's familiar look while fixing the ambiguities that make CommonMark hard to parse efficiently, and adds features like footnotes and definition lists.

Is Djot the same as Markdown?

No, Djot only looks similar to Markdown. It derives most of its syntax from CommonMark but changes several rules to remove parsing ambiguities, so a document written for one won't reliably render correctly in the other.

What is a .muse file?

A .muse file is written in Emacs Muse, a lightweight markup for authoring documents inside Emacs that publish to HTML, LaTeX, and other formats from one source file. It predates most of today's lightweight markups and is closely tied to the Emacs text editor.