Markup Markdown

How to install

The same as usual:

1. Just download and upload the zip file to your wordpress instance. Or install directly by simply searching from the WP plugin panel.
2. Activate the extension.

All done! That’s all you should do.

Is it still compatible with Gutenberg or any other builder?

Yes but you can’t use both at the same time 😉
Data are saved as pure markdown code in the database, for the other builders on the market data are saved as HTML or custom markups like shortcodes. Currently data are still saved but won’t be converted or rendered correctly if you revert back or switch between editors.

Can I switch between editors or allow the markdown editor for specific users ?

Yes, please keep in mind it’s a global switch for every user. You need to stick to one editor with one post type.
Any block editor will be disabled for all the users of your WordPress instance. filters are available to disable the markdown editor for specific custom post types at a global level. For example you can do a setup to use Divi or Elementor to edit your pages and Markdown to edit your blog’posts. Please refer to the forum to know how to do it.

Can I use it with custom fields? (Or within my theme)

Sure, developers & designers can access the public properties & methods of the instance inside their templates through the global mmd function. For example let’s say you want to use it with a custom field called ‘foo_bar’. You can use something
like that:

<?php echo mmd()->markdown2html( get_post_meta( get_the_ID(), 'foo_bar' , true ) ); ?>

Disclaimer: with the plugin Advanced Custom Field (ACF), HTML content has been sanitized since v6.2.5.
If you need to render iframes or others elements, instead of using:

<?php the_field( 'my_custom_field' ); ?>

use

<?php echo mmd()->markdown2html( get_field( 'my_custom_field' ) ); ?>

What’s the deal with the beta interface?

The default editor is based on EasyMDE so you can write in markdown and use WordPress feature at the same time. The side panel preview mode has been fixed since 3.0.
The beta interface is based on SummerNote, a jQuery WYSIWYG Engine. The beta interface has been removed since 3.0 and will be available as a separate addon. It’s a custom version so you can get a live rendering when typing your content or adding medias. It’s not perfect, it’s still working well but for now you will have to modify the code on your own (builder or database) if something goes wrong. To find out more check my article here: https://www.markup-markdown.com/blog/wordpress-plugins/dynamic-input-method-markdown/

Accessibility

The current version is based on components that are not compatible with assistive devices like screen readers. Several available alternative plugins could cover the gap while I’m working on a new interface. Thank you for your patience and your understanding.

Hide FAQ

=3.25.1=

Bug fix:
– Updating cleaning rules

=3.25.0=

Bug fix:
– Nested lists can be generated with 2 or 4 indent spaces

Improvement:
– Possible to select the indent styles from the Layout settings page

3.24.1

Bug fix / Improvement:
– Adding missing classnames for tables for themes using Gutenberg styles

3.24.0

Improvement:
– Adding native basic support for TODO list items

3.23.0

Bug fixes:
– Broken links in footnotes
– TODO list with the O2 Plug

Improvements:
– Adding steam and macappstores in protocols
– Adding the boolean WP_MMD_UNFILTERED_HTML to force disable the HTML sanitizer feature (at your own risk)
– Updating addons / autoplugs loader

3.22.1

Bug fix:
– Patching unselectable radio box on the settings page

3.22.0

PHP 5 dropped, the minimum requirement is PHP version 7.2 so WordPress version 6.6 or upper is now required

Bug fix:
– Restore form related HTML tags when a post is protected by a password
– Fixing a few warnings (deprecated) with PHP 8.4

Improvement:
– Mobile / Tablet layout for the settings page

3.21.0

Improvement:
– Adding Highlight.js as engine for code highlighting

3.20.12

Bug fix:
– Fixing the filter to render the “Read more” link on the archive template with themes built for Gutenberg

Improvement:
– Keeping the use of “” or “” tag with themes built for Gutenberg

3.20.11

Maintenance release:
– Bumping a few dependencies (EasyMDE, Typo.js, Katex)

3.20.10

Bug fixes:
– Adding wp_kses with post_content related filters as well to prevent XSS attacks
– Updating medias related filters for reponsive movies with themes built for gutenberg

3.20.9

Bug fix:
– Image sets for gallery fixed

All gallery shortcodes with legacy or standard themes should trigger properly the lightbox option if enabled with the proper set number.
Any list of images will be converted to a 2 columns layout if the masonry option is enabled AND the post format is set to gallery.

3.20.8

Bug fix:
– Image media filters patched for themes built for blocks editor

3.20.7

Bug fixes:
– Custom classnames used with images aren’t overridden anymore and kept within the HTML code
– WEBP and AVIF media format were added to the gallery filters (Requires “gallery” to be selected as the post format)
– Gutenberg block filter fixed for excerpts (Requires the “Keep blocks features” checked from the settings page)

3.20.6

Bug fixes:
– Fixing excerpt not working on front page with themes built for blocks
– Restoring WP Geshi Highight AutoPlug

3.20.5

Bug fixes:
– Patching media metadata null (missing image) with animated webp
– Adding search template to the markdown filters
– Updating rendering blocks filters for widgets located in the header / footer /sidebar by themes built for Gutenberg

3.20.2

Bug fix:
– Fixing wrong link when inserting media files

3.20.1

Bug fixes:
– Patch wrong cache config patch
– Prefix cache variables can’t be overriden anymore

3.20.0

Improvement:
– Possible to use the backslash character

Bug fix:
– Gutenberg render block filter excluded with current post

3.19.1

Bug fixes:
– Fixing wrong permission with cache folders
– Bumping the revision number of a few assets

3.19.0

Improvements:
– New autoplug for the plugin QTranslate XT
– New addon to enable Prismjs syntax highlighting
– PCP security check passed !

Following recommendations :
1. Missing escaping functions like esc_html, esc_attr, and wp_kses were added
2. Unecessary error_log and console.log were removed
3. masonry and imagesloaded dependencies were removed in favor of the ones bundled with WordPress
4. External FontAwesome dependencies were removed in favor of SVG icons
5. Migrated to WordPress file system methods exists, get_contents, mkdir, move, put_contents, and touch when working with files
6. All translations were unified with the domain markup_markdown

Bug Fixes:
– Missing link in the autoplug tab
– Patching a few wrong urls when debug mode was enabled
– Fixing multiples pipes showing on the toolbar when custom buttons were added

3.18.2

Bug fix:
– Adding a check to verify the configuration file exists. Automatically generated it if need be

Improvement:
– Adding basic final keyword to the primary PHP classes

3.18.1

Bug fix:
– The “Comments”, “LaTeX” and “Mermaid” tabs should not be displayed by default with a fresh install as those addons are optional

3.18.0

Improvements :
– New addon “Mermaid” released !
– Switching from Highlight.js to Prism.js on the backend

Bug fixes :
– Patch a bug with code fences and WP blocks
– Update a few icons
– Disable a few unused filters when markdown is enabled

3.17.1

Bug fix :
– Patch the bug while editing the form settings from the Frontend Admin plugin screen

3.17.0

Improvement :
– New addon “Comments” released !

Bug fix :
– Embedding posts with oembed repaired
– Adding a missing javascript dependency for the frontend with custom fields

3.16.0

Improvement :
– Adding a “Debug” tab to display information required for the support

3.15.2

Bug fix :
– Delete error log warnings with PHP 8.2 and load_textdomain related filters

3.15.1

Bug fix :
– Patch error when saving settings with no selected plugs

3.15.0

Improvement:
– Frontend Admin by DynamiApps added as an autoplug

3.14.7

Bug fix:
– Unwanted HTML stripped with missing breaklines in native HTML code

3.14.6

Bug fix:
– Typo fixed in the latest commit >< My apologizes

3.14.5

Bug fix:
– Tuning reg. expr. and cache query to retrieve responsive assets attributes from the media library

3.14.4

Bug fix:
– Filter modified to trigger markdown rendering for themes that don’t use loops inside single post templates

3.14.3

Bug fix:
– Patching a filter for theme designed for non-block editors when Gutenberg would be loaded instead of Markdown with the ‘post-new.php’ hook

3.14.2

Bug fix:
– Fixing code block fences regular expression and admin panel

3.14.1

Bug fixes:
– Render content and excerpt from markdown posts embedded with the “Query Loop” block
– Warning removed when the image’s array keys are not found inside the render filter

3.14.0

Improvement:
– Adding responsive attributes for WP assets

Bug fix:
– Disable media iframe converter for text links

3.13.0

Improvements :
– New filter: “mmd_disable_gutenberg” added to toggle force Gutenberg on the admin screen even if the markdown editor is disabled
– New plug: Compatibility layer for the plugin Code Snippets added

3.12.0

Improvement:
– Adding support for LaTeX via Katex or MathJax

3.10.2

Bug fixes:
– Updating a few translations
– Various tiny layout features patched

3.10.1

Bug Fix:
– Adding missing files

3.10.0

Improvements:
– AutoPlugs tab added to the settings panel
– BuddyPress and BuddyPress Docs plugs added

3.9.1

Bug fix:
– Solved heading levels upper than 2 rendered as bullet list when heading level 1 was disabled

3.9.0

Improvement:
– bbPress added as an autoplug

Various tiny bug fixes

3.8.2

Bug fix:
– Solved heading levels upper than 2 not working when heading level 1 was disabled

3.8.1

Bug fix:
– Solved an issue with EasyMDE overlay modes when the spell checker styles were not applied

3.8.0

Improvement:
If H1 heading is disabled from the options panel, then inside the WYSIYWIG you can use the sharp sign # for ordered list

Bug fix:
– Editor wasn’t loaded properly if the spell checker was enabled but no dictionary was selected
– A few javascript errors fixed with the spell checker’s suggestions when space or special chars were involved

3.7.4

Bug fix:
Fixing javascript error with selective headings when Code Mirror’s overlay mode was not active. (Related to enabled options)

3.7.3

Bug fix:
Cleaning SVN Trunk >< Sorry for the inconvenience m(__)m

3.7.2

Bug fix:
Quick patch to add missing stylesheets assets since 3.7.0

3.7.1

Bug fix:
Quick patch to add an option to preserve spaces at the beginning of line

3.7.0

New feature:
– Adding support for selective heading levels

You can now prevent the use of specific headings like H1 in the WYSIWYG for better SEO and friendly theme compatibility

3.6.6

Bug fix:
– Removing unwanted spaces (trim) with the headlines

3.6.5

Quick bug fix:
– Patch the PHP error with existing instances when the spell checker is enabled and an extra dictionary file is missing

3.6.4

Bug fix:
– Adding basic strict mode back with Parsedown

Following the markdown recommendations, #headlines text (without the space after the # sign) are not rendered as headlines anymore.

Improvement:
– Keeping current hooks but adding a few tweaks earlier in the frontend so markdown can be triggered with themes built for Gutenberg.

get_header action won’t be fired on the frontend with most of the themes using the blocks editor, wp_head will be too late to setup filters as content related data are prepared earlier in the rendering process.

3.6.3

Improvement:
– Adding possibility to load an extra dictionary file that could be used to add your own custom words in the future

3.6.2

Improvement:
– The spellchecker based on Typojs is shared between multiple code mirror instances
(Performance boost as one unique checker is used even if you are working with several custom markdown fields)

3.6.1

Improvements:
– Disable Emojis added as an autoplug
– Rules added to exclude emoticons from the spellchecker

3.6.1

Improvement:
– Custom code mirror spellchecker updated

One unique event CodeMirrorDictionariesReady will be dispatched once all the dictionaries are loaded
CodeMirrorSpellCheckerReady will be fired when the spellchecker is ready to be used and attached to a code mirror instance.

3.6.0

Improvement:
– Primary scripts now minified as a unique bundle file

By default builder.min.js is loaded.
If WP_DEBUG is enabled, separate minified module scripts will be used.
If SCRIPT_DEBUG or MMD_SCRIPT_DEBUG is turned on, the unminified version available of a module will be loaded when available

3.5.0

New feature:
– Adding buttons and support for RTL

Improvements:
– Better support with multisite
– Hooks more friendly with plugins like CPT UI (Custom Post Type) and ACF (Advanced Custom Field)

3.4.2

Improvements:
– Basic internationalization strings added
– French version released as local for now

Bug fix:
– Adding css namespace for the toolbar buttons to avoid collision with Bootstrap on the frontend

3.4.1

Improvements:
– Adding missing filters in the REST Api
– Adding a plug for the description field with Woocommerce templates

Bug fix:
– Undefined variable in array with WP Geshi

3.4.0

Improvement:
– Adding markdown support by default for category, tags, and term descriptions

3.3.8

Bug fix:
– Activate markdown filters on the front page / home page as well

3.3.7

Bug fix:
– Patch a PHP warning if the align attribute was missing

Improvement
– Adding a few missing styles inside the preview panel

3.3.6

Bug fix:
– Fixing PHP error with undefined array key

3.3.5

Bug fix:
– Adding a whitelist on the REST hook to allow the rendering of markdown with REST content

3.3.4

Bug fixes:
– Removing blank icon in the toolbar when the spell checker addon was disabled
– Fixing the case when a custom image size was overriden by wordress predefined size

3.3.3

Bug fix:
– Patch a cache issue with (my) shared webhosting with the WP Geshi AutoPlug

3.3.2

Bug fix:
– Patch a javascript error with an undefined variable

3.3.1

Improvements:
– Markdown extra patches added to support HTML multi-attributes
## Headline {#h2 .short .great lang=en} => <h2 id="h2" lang="en" class="short great">Headline</h2>
– Basic block classnames added to headlines and images to avoid broken layout with themes built for Gutenberg
### H3 Tag => <h3 class="wp-block-heading">H3 Tag</h3>
– ACF Markup Markdown custom fields can now be used in the frontend with acf_form_head & acf_form

Bug fix:
– Static Cache is disabled by default to avoid side effects with a few cache engine
– Filters fixed: when cache was turned on, excerpt was returning the content value

New feature: AUTO PLUGS
Unlike Addons designed to add extra features to the editing experience, the Plugs will be designed to smooth the behavior of the rendering with existing WP plugins.
The first plug with WP Geshi Highlight has been added to allow the rendering of snippets on the frontend

3.2.6

Readme.txt Updated

3.2.5

Improvement:
– Patch to refresh the editor when the spell checker is disabled

3.2.4

Bug fix:
– Patch to refresh the view with frozen loader icons

3.2.3

Bug fix:
– Patch for markdown contents not rendered on archive templates and REST calls

3.2

Bug fix:
– Bug introduced with version 3 for the custom post type support filter has been fixed

Improvement:
– “ACF Markup Markdown” custom field with custom post type !

3.1.0

Improvements:
– The preview panel has a tiny cache feature to avoid flickering issue when using the side panel view
– Better support in responsive mode for the sticky toolbar and fullscreen mode

3.0.1

Hotfix:
– Namespace Patch for the Extra Parsedown

3.0.0

Refactored !

New feature:
– Possible to select and sort the buttons displayed from the toolbars

2.6.1

Bug fix:
– Forget to bump assets version number to avoid cache issues when upgrading

2.6.0

Improvement:
– Adding option to make the default EasyMDE toolbar sticky

2.5.1

Bug fixes:
– PHP: Addons config file not properly created with new installs & upgrades
– JS: Undefined variables when the spell checker was not activated

2.5.0

Improvement:
– Adding option to disable the static html cache

2.4.0

Improvements:
Possible to do the following actions from the media uploader
– Adding an audio file
– Adding a video file
– Creating an audio playlist
– Creating a video playlist

Bug fixes:
– Music or movies was not usable
– Inserting multiples images at once or creating a gallery should work properly
– Solve an issue to avoid duplicate ids with images when using custom fields
– Better performance with a unique media wizard per page instead of one media wizard per custom field

2.3.0

Improvements:
– New beta interface based on HTML markups for better accessibility
– A few dependencies are now loaded from the UNPKG CDN (https://unpkg.com/)

Bug fix:
– The parser has been patched to be compatible with PHP >= 8.X

2.2.2

Bug fix:
– Lightboxes working again with the gallery shortcode

2.2.1

Bug fixes:
– Adding missing 2 & 3 columns styles for the gallery in the preview rendered by EasyMDE
– Shortcodes now working in the preview page rendered by WordPress (The one with /?preview=true in the url)

2.2.0

Improvement:
– Enabling “Screen options” on the top right area of the settings page so you can activate or disable addons one by one

2.1.2

Bug fixes:
– Forcing WP medias tools to be available to avoid errors with some specific hosting
– CodeMirror instances now available from wp.pluginMarkupMarkdown.instances array for developers

2.1.0

Improvements:
– Better media support with native WordPress Modal UI for editor in the admin panel
– Tiny responsive features added for images uploaded via WordPress on the frontend (srcset)
– Alignment and caption now works, converted as

<

figure> on the frontend
– Default shortcodes should support columns & size attributes as well
– Syntax highlighting enabled in the preview

Bug fixes:
– 404 with one single dictionary activated
– Styles broken in the preview (conflict with default admin panel style)

2.0.2

Bug fix:
– Make the [my_gallery] shortcodes rendered as thumbnail galleries in the preview

2.0.1

Bug fixes:
– Patched the error when the config file was not found after upgrading

2.0.0

Code refactoring. Addon framework created !
Please setup and save again your settings again if need be. Sorry for the inconvenience.

New feature:
– Advanced Custom Field (ACF) support added with a “Markup Markdown” content field

1.9.3

Improvement:
– Add Polylang compatibility by switching dictionaries order when editing a post in an alternative language

1.9.2

Bug fixes:
– Undefined variable with fresh install
– Editor was blocked in case one of the dictionary was not found

1.9.1

New features:
– Spell checking (experimental)
– Fresh settings panel

Bug fixes:
– Update EasyMDE version to 2.18.0 (Wrong version in previous commit, my bad)

1.7.4

• Deleting experimental user interface
• Adding WP_MMD_RAW_DATA constant for developers to disable the HTML output filter
  at a global level through the wp-config.php file or at a local level with hooks
  inside your child theme

1.7.3

Bug Fixes :
– Masonry setup fixed for the gallery layout

1.7.2

Improvements:
– New settings page with default layout options

1.7.1

Improvements:
– Adding feature to disable the editor for custom post types

In your child theme just turn off the markdown editor by adding the following snippet :

php

add_action(‘init’, function() {
remove_post_type_support(‘post_type_slug’, ‘markup_markdown’);
});

Bug Fixes:
– Remove debug lines

1.6.0

Improvements:
– Removing curl straight dependencies in favor of wp_remote_get functions
– Youtube oembed support added
– Remove unused files

1.5.4

Bug Fix:
– Public method mmd()->markdown2html fixed

Since the cache support from v1.3, the method was broken when used in templates.
The cache is only restricted to the post / page content.

1.5.3

Improvement:
– Vimeo arguments support added.

Please refer to the link below for the complete list :
https://developer.vimeo.com/api/oembed/videos#embedding-a-video-with-oembed-step-1

Ex: https://vimeo.com/30198629/&quality=360p

1.5.2

Bug Fixes:
– Space at the beginning of the file and other typo
– Unknown unused callback

1.5.1

Bug Fixes:
– Multiple Vimeo url not working
– Non existent minified related map files removed

Experimental UI:
– Headlines input fixed
– HTML tags sidebar’s prototype released

1.5.0

Experimental UI: Adding modern syntax via summernote wysiwyg
Find out more here: https://www.youtube.com/watch?v=cl2P5zUXAmU

1.4.0

Improvement: Parsedown extra plugins added so you use extra features

1.3.3

Bug Fixes:
– Site ID used for the static cache rules, now compatible with network sites
– Regexp updated for vimeo videos
– Espaced quotes fix and lower filter priorities so other shortcodes can be parsed properly

1.3.2

Bug Fix: adding rules if cache directory not available

1.3.1

Adding cache via static files in the mmd-cache directory.

1.2.5

Adding Vimeo support. Vimeo links will be converted to iframes.

1.2.4

Bug Fix: Enabling gallery with archive templates

1.2.3

Bug Fix: Editor styles adjusted with WordPress

1.2.2

Bug Fix: Single image button not working properly

1.2.1

New Feature: Image Gallery using Lightbox and Masonry for the image gallery post format

1.1.2

Bug fix: modal preloading (Double click was required to add an image from the library)

1.1.1

Adding Youtube support. Youtube links will be converted to iframes.

1.0.1

Updates to match the WordPress Plugin Directory requirements

1.0.0

First version ! ! ! Based on:
– Javascript easyMDE 2.15.0
– PHP Parsedown 1.7.4

Developers can access the instance instance through the mmd() global function