[Plugin] MarkdownImport - Markdown to HMTL converter
#1  Doitsu 11-09-2019, 02:12 AM
Released: November 11, 2019
Current Version: "0.1.2"

This plugin allows you to import self-contained UTF-8-encoded Markdown files and plain text files without markup.
For more information on the Markdown syntax, see this website, which also offers an interactive Markdown tutorial for beginners.


This plugin uses cmark-gfm for the actual conversion. (KevinH and DiapDealer kindly provided the macOS and Windows binaries bundled with this plugin. KevinH also updated the code to support non-standard epubs.)

System requirements

This plugin requires Sigil 0.9.8 or higher. If you uncheck the Use Bundled Python option, you'll also need to install Python 3 and PyQt5. Linux users will also need to install the cmark-gfm package.


1. Select Manage Plugins from the Plugins menu and enable the Use Bundled Python option, if it isn't already enabled (or greyed out).
2. Click Add Plugin and select This will install the plugin, which you can select via Plugins > Edit > MarkdownImport.

If you want to test the plugin, copy and plugin.png from the plugin folder to your Desktop folder, run the plugin and then select as the input file.


Advanced users can change some conversion settings by editing the following MarkdownImport.json entries:

"extensions": ["footnotes", "table", "strikethrough", "autolink", "tagfilter"],

This entry defines the extensions that'll be used. For more information on these extensions, see the GitHub Flavored Markdown Spec guide.

"strong": true,

By default, the plugin will generate <strong> and <em> tags. If you prefer <b> and <i> tags, change this setting to false.

"sigil_split_marker": false,

If you change this setting to true, the plugin will add sigil_split_marker class attributes to all <hr> tags (defined as --- in Markdown files). This will allow you to split the file using Edit > Split At Markers.

"cmark_exe_path": "C:\\Users\\user\\AppData\\Local\\sigil-ebook\\sigil\\plugins\\MarkdownImport\\cmark-gfm.exe"

This entry defines the cmark-gfm path. You can change this setting to specify a custom cmark-gfm path.

License: GNU General Public License v3 (GPL-3)
[zip] (208.9 KB, 194 views)

#2  Vroni 11-09-2019, 03:30 AM
exe file? Windows only?

#3  Doitsu 11-09-2019, 03:31 AM
Quote Vroni
exe file? Windows only?
No, a macOS binary is bundled with the plugin. Only Linux users will need to install the cmark-gfm package.

Today's Posts | Search this Thread | Login | Register