Я смотрю на использование Sphinx / reStructuredText для документации, и это выглядит очень многообещающе, за исключением того, что таблицы выглядят затруднительно. Есть ли редактор, который может помочь?
Emacs действует по умолчанию (или наиболее естественный выбор) для редактирования reStructuredText. Имея это в виду табличный режим очень хорошо сочетается с тем, как reST делают таблицы.
ReSTedit хорошо и просто, если вы используете Mac. На странице Википедии перечислены другие.