Contributors: stephenharris
Donate link: http://www.stephenharris.info
Tags: markdown, formatting,prettify,syntax highlighter,code
Requires at least: 3.1
Tested up to: 3.6
Stable tag: 1.4
Allows Markdown to be enabled in posts, comments and bbPress forums.
This plug-in allows you to write posts (of any post type) using the Markdown syntax. The plug-in converts the Markdown into HTML prior to saving the post. When editing a post, the plug-in converts it back into Markdown syntax.
The plug-in also allows you to enable Markdown in comments and BBPress forums. In these instances the plug-in adds a toolbar, and preview of the processed Markdown with Prettify syntax highlighter applied (similiar to that used in the Stack Exchange websites such as WordPress Stack Exchange).
WP-Markdown stores the processed HTML, so deactivating the plug-in will not affect your posts, comments or bbPress forums.
Installation is standard and straight forward.
- Upload
markdownfolder (and all it's contents!) to the/wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Go to your Settings > Writing page and enable markdown for the appropriate post types and comments.
For information on how to use Markdown sytnax pleae read: Markdown: syntax.
The plug-in uses Markdown to generate the appropriate HTML prior to the post saving to the database. When you edit a post, it is converted back to Markdown syntax. Once the plug-in is uninstalled you'll simply rever to editing the posts' HTML.
A clean install of WordPress allows you to (for example) include a YouTube url on a seperate line, whereupon it will automatically embed the video. This is not possible with WP-MarkDown installed (I tried - I broke more things. But if you manage it, feel free to make a pull-request: https://github.com/stephenharris/WP-MarkDown).
You'll need to use the [embed] shortcode.
Enclose it in a div tag. It'll be ignored.
Use <div markdown="1">.
###1. The Markdown toolbar and previewer on a bbPress forum###
###2. Plug-in settings, located at the bottom of the Writing settings page###
###3. The Markdown toolbar and previewer on a comment form###
###4. Example of Markdown syntax###
###5. The output of the example Markdown###
###1.4 ###
- Fixes issue with consecutive shortcodes.
- Fixes editing bbPress topics/replies on the front end corrupts MarkDown. See #25
- Apply kses and balance tags after MD->HTML conversion. See#23
- Compress scripts and minify icon sprite. See #7
- Adds 'more' tag to MarkDown editor.
- Adds support for iframes. See #22.
- Fixes bug with underscores in shortcodes.
- Adds support for tbody, tfoot and thead tags
- Refactoring including renaming of plug-in style & script handles.
- Fixes problems with images nested inside links. See #12
- Ensure prettify is loaded, if needed, on home page. See #6
- Updated Markdownify
- Updated Prettify
- Removes the wpautop/unwpautop functions. If using oembed, use embed shortcodes.
- Adds public wrapper functions.
- Remove bbPress front-end tinymce editor if using MarkDown
- Fixes bug introduced in 1.1.4 where line breaks are stripped (affects code blocks).
- Fixes bug where oembed would not work. Thanks ot Michael & Vinicius
*** Adds a filters for MarkDown 'help' text:**
wpmarkdown_help_text - Support for MarkDown extra (currently not supported in pagedown previewer)
- Stable with WordPress 3.4
- Fixed bug relating title attributes for links and images
- Fixed bug relating to comments by logged out users
- Fixed backslash bug
- Added option to replace TinyMCE with Markdown help bar on post editor
- Initial release
If you have upgraded to 1.1.4, please upgrade to 1.1.5. This release fixes a bug introduced in 1.1.4 (see http://wordpress.org/support/topic/plugin-wp-markdown-breaks-oembed-support)
- Added option to enable the Markdown help bar on the backend post editor. Simple check Markdown help bar for 'Post editor' in the settings.