How to write documentation (not code-based)?

Question

Documentation

There is a desire to write a userguide (a multi-page tutorial, not a generated documentation for the project). Basic requirements:
1. Ability to export to HTML (online version)/PDF (offline).
2. Preferably based on files. Then I want to take out the texts in github.
3. It will be enough offline, because. I will write alone.
4. If there are plug-ins for editors for this program, it's generally good.
5. Images, code inserts and other nice things are planned in the text. I want it all to look beautiful in the end, without unnecessary gestures on my part (yeah, I'm lazy).
6. i18n is not critical, although it would be cool.
Thanks for the help.

Answer 1

I use latex. From my point of view, nothing better has yet been invented.

Answer 2

Markdown, Emacs Org-mode, LaTeX.

Answer 3

I have been using Help&Manual for many years .

Answer 4

My choice is files in markdown in a folder, all this is on github.
I advise everyone. Reads like plain text great.
See how it looks:
doit-cms.ru/docs/docs.php?file=active_record (the same files through the php viewer, they are also on github)
github.com/ramainen/doit-cms/tree/master/docs - list of pages. Native, comfortable.
github.com/ramainen/doit-cms/blob/master/docs/active_record.md - highlight out of the box.

Answer 5

1. LaTeX.
2.Word.

Answer 6

1. LaTeX
2. Sphinx
3. My own set of scripts for text processing in Markdown formats
4. Docbook
I personally use LaTeX and Sphinx and they are enough for me to be completely happy.