tomd

Automated conversion from .textile to .md with pandoc

Users with many Textile files in their Jekyll Pages site can leverage pandoc, a utility for converting between different markup formats.

The tomd shell script uses awk and sed to overcome the biggest limitations of pandoc, filtering out the sections listed below, which pandoc doesn't recognize, and re-inserting them into the converted Markdown.

• YAML frontmatter at the top of .textile files
• {% highlight %} blocks
• <notextile> blocks

To run tomd

1. Install pandoc from https://github.com/jgm/pandoc/releases or here.
2. Download or clone this repo.
3. Copy the tomd script and the two .awk files into your Jekyll project.
4. Invoke the script with ./tomd from inside your Jekyll project folder.
5. Validate the results.

The script will look for any .textile files in the _posts directory, convert them to .md, and leave backups of the original .textile files in a new directory called _old_posts. You can override the names of the directories with arguments to the script.

If everything works, you will see output like:

NOTE: This process may still produce some incorrect output, so check your results.

Known issues include:

1. Lost CSS references e.g. from Textile .p(classname)
2. Literal HTML mixed with Textile formatting e.g. <sup>"textile-link-text":url</sup>

Running under Windows

The latest version of pandoc for Windows can be downloaded from https://github.com/jgm/pandoc/releases/.

In addition to pandoc, tomd requires a unix-y shell and utilities. The easiest way to get those for Windows is by installing the default set of cygwin utilities.

Before running tomd, use cygwin dos2unix and run it against the tomd file to remove extra linefeeds.

The output of running tomd in the cygwin shell should look very similar to the OSX output above.

NOTE

tomd has run successfully under OSX and Windows against a couple of repos, but it was not extensively tested, so use at your own risk. Also, please make backups of your content!