Какую выбрать систему для онлайн документации?

Question

[ilya_compman]

Хотим оформить документацию для API нашего проекта, но не смогли найти подходящий сервис. Нужно что-то викиобразное, но без необходимости установки на свой хостинг (желательно).
Пробовали editorially.com, но там нет возможности создать html-каталог для проекта.

Требования:
* Ограничение доступа
* Поддержка Markdown

Answer 1

[konfetolog]

А зачем именно Markdown?
Почему не WYSIWYG?

Comments

[ilya_compman]

Уже часть документации в маркдауне написана, но если есть такая штука для визивига — буду рад посмотреть

[konfetolog]

Имхо лучше сразу искать визвиг и конвертировать весь маркдаун в html. Когда работаешь со сложными текстами, большой структурой, то отвлекаться на синтаксис крайне неудобно. Да это еще полбеды, он простой и выучить его можно моментально. Но вот основная проблема в том, что при написании не видно сразу результата. Это как скульптор ваял бы месяц статую, а потом оп - и и только тогда увидел результат.

[ilya_compman]

Почти все маркдаун-редакторы сразу отображают результат, в том-то и прелесть.

[konfetolog]

Ну я прелести что то не ощутил, только неудобства.

[konfetolog]

Илья, я может не умею их готовить, можно пример такого редактора, который удобный?

[ilya_compman]

https://stackedit.io/

[konfetolog]

Довольно симпатично. Но это буханка и троллейбус. Моя бритва Оккама достаточно остра, чтобы убрать к чертовой матери всю левую половину.

[gpm7315]

konfetolog, разделяю ваше мнение, возиться с разметкой еще тот мазохизм. Может посоветуете норм сервис форматирования текста для документации.