Blog

Hexo Markdown Export for Clarify

Clarify2 from Blue Mango is an excellent tool for creating small posts where annotated images and text are mixed. It can also export to a few platforms such as Evernote and Wordpress as well as in PDF, Word, HTML and Markdown.

01433df1-d249-43d6-b02d-f82a33f3a857.png

Clarify2 also provides a way to customize the export templates, by amending the processing script. I’ve create a small version of the sample export script for Markdown, which I’ve tailored to output a file for the Hexo blogging platform. The Hexo output format does include a header “Front-Matter” section, images to be stored in a separate folder, and finally some script based tags for images which deviates from standard Markdown syntax.

The export template is available on GitHub https://github.com/mry/clarify-markdown-hexo/releases and can be downloaded as a zip file.

Locate Custom Template Folder

Open the “Customer Template Folder” in Finder

In the Help menu of Clarify, select the option “Reveal Custom Template Folder” to have Finder open the template folder.

We will install the Markdown Hexo export template by copying it into the HTML folder.

locate-custom-template-folder.png

Installation

Download

Download the latest release from GitHub https://github.com/mry/clarify-markdown-hexo/releases.

installation.png

Extract and Copy folder

Extract the zip file and copy the folder “Markdown Hexo” into the HTML folder of the Custom Template folders.

c4462735-4bdb-41f6-8d25-c8487b9566cc.png

Restart

Restart Clarify to have it pick up the new Custom Template.

Define a new Share Account

  1. Click the Plus icon and choose a new HTML template.
  2. Give it a name
  3. Select the newly added Export Template “Markdown Hexo” from the list.
bacf20d9-f2ac-4d7b-b92c-f88e4f93038a.png

Exporting from Clarify

Export either via the File->Export->HTML-Markdown Hexo option or click the Share button.

exporting-from-clarify.png

Export destination

A markdown file and corresponding asset folder is created (remember to enable “post_asset_folder: true” in the Hexo configuration). Place it either in _drafts on in _posts depending on your configuration.

ab6f2098-8da5-4746-b90d-4f63320bc6c8.png

Markdown

The export templates adds the Hexo Front-Matter section. Including title, updated and any defined tags you’ve set.

325d1d14-2fee-4ce7-99a3-2ea38e78ee1f.png