Markdown Editor plugin

[Carlos]

Markdown Editor - Download

This plugin allows you to create and edit pages using the Markdown syntax.

Existing pages created with the normal HTML editor will still use the default editor (CKeditor, raw HTML or whatever)

The page content is converted to HTML (by Parsedown, included) and stored in the content field, so plugins that expect it to be HTML will not be affected.

(Your Markdown content is stored in a hidden field, contentmd, to be swapped into the editor when you re-edit the page.)

If you later decide to stop using Markdown, just remove or deactivate the plugin. Your content will be available as HTML (though if you re-edit and save any page, its Markdown field will be lost).

There are two ways to use this plugin: mixed mode (default) and Markdown-only.

Both Markdown and HTML - mixed mode (default)
You will find a "Create new page (Markdown)" link in your page management sidebar to create pages using Markdown. The "Create new page" can be used to create a page that will always be edited with the normal HTML editor.
This is the default behaviour.
Optionally you can change the sidebar link text by inserting this in gsconfig.php (example):

Code:

define('MARKDOWN_ADDLINK','Create Markdown page');

Markdown-only mode
The "Create new page" link in the page management sidebar will be used to create Markdown pages.
You cannot create new HTML pages, but if you edit previously created pages the HTML editor will be used.
To enable this mode, insert this in gsconfig.php:

Code:

define('MARKDOWN_ADDLINK', false);

If you have an existing page and you want to stop using HTML but Markdown instead, you can:

- Delete it, and create it again (Markdown)

- Or, if you use Markdown-only mode: delete its content and save the page. You'll now have an empty Markdown page.

- If you use mixed mode you can do the same as above, but you first have to insert this in gsconfig.php:

Code:

define('MARKDOWN_EMPTY', true);

(if you don't, the empty content will still be HTML)

This plugin doesn't currently convert HTML to Markdown. You can use some online tool like to-markdown or others.

There's an additional setting that allows disabling the plugin without deactivating or removing it:

Code:

define('MARKDOWN_EDITOR', false);

(This may not seem very useful, but can be used in combination with the UserConfig plugin, e.g. if you only want to allow using Markdown to certain users)

TO-DO: syntax highlighting