3

What are some good simple CMS program that support markdown? Namely, I want to create documentation/tutorials for various things at my company and I want something that:

  1. I can setup easily
  2. Looks nice
  3. Let's me edit a page directly from the browser
  4. Let's me somehow backup the markdown in raw format (in case of the platform crashing)

So far I've found Harp, Strapdown.js and Luminos but would like to hear what others have to recommend and why.

  • What do you mean with "platforms"? Websites? If yes, with backend (editing in the browser), or via uploading Markdown files (editing in a local editor)? – unor Dec 17 '14 at 15:09
  • @unor well I am not sure what I am looking for. I want something that looks like read-the-docs or github's wiki, that I can run on my own server. – Pithikos Dec 17 '14 at 15:14
  • ownCloud has a Markdown editor integrated. Might be interesting if you'd like to have a calendar, address book, file storage, etc. as by-products. – Izzy Dec 17 '14 at 16:16
  • 1
    It sounds like you want a wiki. Do you have any particular constraints on who can edit each page? Usually the kind of documentation you'd put on a web page in a company is stuff needs to be editable by anyone who changes it. Also, is markdown itself necessary, or are similar mini-markup languages ok (in which case just about any wiki would do)? – Gilles Dec 17 '14 at 21:19
  • 2
    @Pithikos How is wiki bloated? They come in all sizes and shapes. And what on earth does “looks slick” mean? Please edit your question to clarify it. – Gilles Dec 18 '14 at 10:51
1

After some research I found two candidates:

  1. Logdown
  2. Github pages with Jekyll

Logdown is just a cool technical cloud blogging tool. That takes away some freedom..

For that reason I chose the second choice which is essentially Github's free hosting for webpages. It has quite some work to get it work with markdown but it gives you freedom.

0

I think that Yellow could meet your needs. There is a demo at that link, or you can see the documentation on Github. Here's how it meets the criteria:

  • Yes I can setup easily | Copy files to your server (needs PHP). Done.
  • Yes Looks nice | Note See the available themes; can be tweaked, of course.
  • Yes Let's me edit a page directly from the browser | Yes - this is what attracted me to Yellow in the first place.
  • Yes Let's me somehow backup the markdown in raw format (in case of the platform crashing) | It's just folders and files: back up any way you want.

I've trialled this and used it for a small course-website. Works a treat. It's GPLv2 licensed.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.