Have you used Markdown for large content editing?

Question

I am putting together a system for writers/editors to efficiently add — fairly rich — content to a website.

I've previously used standard WYSIWYG editors but find that often what you see isn't what you get. I've seen this lead to frustration and bad code.

Has anyone implemented Markdown to write articles? If so, how did you find it? I like the idea of saving articles in markdown as it keep HTML separated from the content.

Has anyone implemented any other systems?

Answer 1

The best solution I've ever seen for editorial content is Xopus. (Disclaimer: Xopus was originally created at my company). It's an XML authoring environment used by many companies around the world. An example is Philips, who use it internationally for writing the content of instruction manuals they provide with their products. Here's a description from the website:

SDL Xopus is a WYSIWYG XML Editor that runs in your browser.

SDL Xopus enables authors to work with structured and complex content without the need for technical knowledge. By using a friendly interface to XML, the author cannot break the XML structure or write content that does not conform to the XML Schema.

Why it's great:

• Content is saved in XML, which means it's structured semantically
• However, editors never see or know they're writing XML, because Xopus provides a WYSIWYG interface to that XML
• This is achieved by using XSLT to transform the underlying XML into a view that corresponds with whatever the editor is working on. In Philips' case, editors see the layout and design of the instruction manual they're writing for.
• The XML is validated against an XML Schema, meaning the document can never be invalid. Xopus prevents users from doing anything that's impossible in the Schema, like adding more than one title or trying to create a hyperlink where you don't want them to be able to.
• It's online and web-based, meaning you can install it in one place and people can access it from anywhere

It's easily licensed and affordable. The only downside is that you have an upfront implementation cost that you need to invest in. You'll need a development team to specify your XML Schema so Xopus knows what constitutes valid documents, and then you'll need to write the XSLT to transform your XML into a view your editors can work with. But once you have it up and running, editors can get started writing content, and you'll end up with clean, valid XML that your development team can feed into any publishing platform they want.

Take a look at some of the demos where you can try it out and see how it works for yourself. (Note: Webkit browsers are not supported)

Answer 2

Doesn't Wikipedia count as "large content editing"?

I think they have successfully proven that markdown can work for large content, so you could look at how they implement it. Bare in mind that the user group that creates and edits articles is not the consumer group, and what they find simple may not apply to most users.

Answer 3

Consider the concept WYMIWYG – What You Mean is What You Get. There's an editor called WYMeditor which I rather like, but it's getting long in the tooth. Markdown etc are in a similar vein.

If you're crazy you can use DocBook, TEI, or some other heavy-weight publishing markup system. These are designed for books, so they're overkill for a website, and have a learning curve.

Consider also basic RTF (Rich Text Format), like you get in Mac OS X's TextEdit.

Or what about plain text?