I prefer to use Multi-Markdown for my specific syntax. This is a guide for others who wish to set it up in a sane way without reinventing the wheel.
The syntax guide is on github.
Anyhow, first thing to do, once you have multimarkdown functioning for your system, is to create an Export Extension.
~/.local/share/retext/export-extensions/multimarkdown.desktop file and put the following contents there:
[Desktop Entry] Name=HTML (MultiMarkdown) Exec=/usr/local/bin/multimarkdown -o %of %if X-ReText-FileFilter=HTML Files (*.htm *.html)
However, in practice that will not overwrite a file already saved, dispite having to confirm it.
My solution was a simple bash script (I am using a Xubuntu machine). Below is the source of my script as well as the final export command.
Script (Saved at /usr/local/bin/retext-mmd2html):
1 2 3 4 5 6 7
#!/bin/bash # Remove the file should it already exist. if [ -f $1 ]; then rm $1 fi # Create the file, using the absolute path to the multimarkdown command /usr/local/bin/multimarkdown -o $1 $2
Contents of extension file when using this script:
[Desktop Entry] Name=HTML (MultiMarkdown) Exec=/usr/local/bin/retext-mmd2html %of %if X-ReText-FileFilter=HTML Files (*.htm *.html)
If you want to make use of the other multi-markdown export options, just add the appropriate -t option to the script. Also, make sure to remember to chmod the script so you can execute it.