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.

Improve this question
11
  • 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, 2014 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, 2014 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, 2014 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 'SO- stop being evil'
    Dec 17, 2014 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 'SO- stop being evil'
    Dec 18, 2014 at 10:51

2 Answers 2

Reset to default
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.

Improve this answer
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.

Improve this answer

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

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