Welcome!Want to know more about MarkdownWiki and receive updates on our progress? Click here!
MarkdownWiki is a hosted wiki platform that allows you to easily create documentation for your projects, take notes for class, or organize your company's internal content. All of this is possible through the simple markup language Markdown.
Improving Wiki Editing with Markdown
The other day, I was tasked with updating a page on a wiki. This wiki happened to be hosted using the classic MediaWiki platform. The page I was editing involved me creating a table for some test data that I had gathered. Immediately I found myself googling for the proper syntax for creating a table in the (archaic) wiki syntax. If the syntax was parsed in Markdown or pure HTML, creating a table would have been MUCH easier and wouldn't have required me to look up the proper syntax.
Improving Wiki Editing
For the longest time, when you edit a wiki, be it on a MediaWiki platform, confluence, or even on Github using markdown, you are always editing a plain text document that has no syntax highlighting to help you decipher what you are typing. With MarkdownWiki, we are about to change ALL of that. Here is a screenshot of the MarkdownWiki editor:
First thing to notice is that MarkdownWiki provides you with a complete, syntax-highlighted editor. This allows users to see exactly what they are creating and makes it much easier to catch errors and makes creating and editing pages much easier.
If it ain't broke, don't fix it
Since the launch of Github, the Markdown syntax has caught on real fast. So fast that Github created their own flavor of markdown. To keep make it so that you don't need to potentially learn another "flavor" of the Markdown syntax, we have adopted the Github flavor of Markdown. To stay consistent with their syntax, that means we had to find a parsing library that was compatible. Luckily, other people had the same idea as us, and have begun to develop compatible libraries for all the popular languages. Github, being a site based on various Ruby libraries, uses the redcarpet library to convert their Markdown to valid HTML. As it turns out, their parser is built around the C-based library, (sundown)[https://github.com/tanoku/sundown]. Since MarkdownWiki is built on top of NodeJS, it made sense to find a library compatible with Node. Thankfully we were able to find just that; a Markdown libarry that wraps sundown, built for NodeJS called robotskirt. Why it's called that, I have no idea, but it works beautifully and works great with the Github flavored markdown.
Here's a preview of what a typical wiki page will look like (the sample content is the example Markdown from Github's Markdown documentation):
More syntax highlighting!
The icing on the cake here is the added support for code syntax highlighting within your markdown. Thanks to highlight.js MarkdownWiki supports 46 languages out of the box. Heres a quick look at how to take advantage of it:
Simply provide the name of the language the block of code is, and highlight.js will choose the correct highlighting stylesheet.
Some editor features
We think that this interface will greatly improve the user experience, making it easier than ever to create and edit your wikis. If you disagree with us, we would love to hear why. If you absolutely love what we are doing, we also want to hear it! We are here to provide YOU with what will be easiest for YOU.Read more and comment