Super User is a question and answer site for computer enthusiasts and power users. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I'm looking for an

  • open source
  • cross platform

editor that I can use to write documentation. I'm not looking for a web based solution - i.e. it should work without a web server, and I want to save my files directly to disk.

The result could be any structured format, like Wiki markup, ReStructuredText, DocBook, or a small subset of HTML, ... But it's important, that

  • Subversion diff can be used to see differences between the versions easily (this wouldn't work with .odt or .rtf files for example)

I'm currently thinking about using Open Office, and saving the files as HTML, but is there a better solution?

share|improve this question
up vote 1 down vote accepted

If you're going to save as HTML it might be better to use a dedicated HTML editor like KompoZer, which is WYSIWYG, open-source and cross-platform.

share|improve this answer
@Hugh: Thanks for this link! I just installed it (it's even in the Ubuntu Repository BTW :-), and it already looks quite promising: I like its interface, and it produces very clean HTML. The split view is practical, too. It even seems to handle long files pretty well. – Chris Lercher Apr 2 '10 at 10:01

Use plain text and your favorite programmer's editor.

As format I would suggest asciidoc since its markup is very non-intrusive and it can be converted to HTML, DocBook and others pretty easily. This will make the diffs much more pleasant to look at.

share|improve this answer
@honk: I love programmer's editors, and use them for almost everything. But in this case we need real WYSIWYG... – Chris Lercher Apr 2 '10 at 0:36
@chris: asciidoc almost is a WYSIWYG markup ;) – Benjamin Bannier Apr 2 '10 at 0:37

A little bit late, but Texts fits your requirements except being open-source. It's WYSIWYG, works on Mac OS X/Windows and saves files in Markdown format that is diff-friendly.

share|improve this answer

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .