Description

This package installs a Markdown Property Editor plugin into your Umbraco V5 website.

What is Markdown?

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format and then convert it to structurally valid HTML. Further information here: http://daringfireball.net/projects/markdown/

What is the WMD Editor?

WMD is a simple, lightweight HTML editor for basic content management. The WMD editor became extremely popular due to its use on the StackOverflow website.

The original WMD Editor website:  http://wmd-editor.com/

What is PageDown?

PageDown is the version of Attacklab's Showdown and WMD as used on Stack Overflow and the other Stack Exchange sites.

It includes a converter that turns Markdown into HTML, a Markdown editor with real-time preview of the generated HTML, and a few useful plugins, e.g. for sanitizing the generated HTML according to a whitelist of allowed tags.

The Markdown converter can be used both in the browser (usually in conjunction with the editor, to display a real time preview), and on the server using Node.JS.

For more information, please visit http://code.google.com/p/pagedown/

What is MarkdownSharp?

MarkdownSharp is an open source C# implementation of Markdown processor, as featured on Stack Overflow.

More information in http://code.google.com/p/markdownsharp/

Syntax

Get the text from the pasteme.txt file, and paste it in your WMD editor to see how the syntax works.

How to use it

Once the package is installed, then go to the developer section and right click Developer > Data types > Create. Give a name to the new data type and select "Markdown" from the dropdown list.

To convert the markdown format to html, import the namespace Our.Umbraco.Web.PropertyEditors.Markdown and use the helper MarkdownHtmlHelper.MarkdownToHtml. For example, this is the code I'm using in /Views/Umbraco/Homepage.cshtml

@MarkdownHtmlHelper.MarkdownToHtml(DynamicModel.BodyText.ToString())

Thanks

·         Lee for sharing his article http://www.blogfodder.co.uk/2011/11/21/creating-a-google-map-property-editor-for-umbraco-v5

·         Tim http://www.nibble.be/?p=104

·         Warren  http://umbraco.com/follow-us/blog-archive/2012/1/26/creating-my-first-v5-package.aspx

·         Lee Kelleher for the Markdown editor for V4 http://our.umbraco.org/projects/backoffice-extensions/markdown-editor

Other resources

·         http://code.google.com/p/pagedown/

·         http://code.google.com/p/markdownsharp/

Looking for a V4 version?

There is an excellent Markdown package written by Lee Kelleher http://our.umbraco.org/projects/backoffice-extensions/markdown-editor available for Umbraco V4