A https://readme.md/ is brilliant for small projects. For very large projects, there are lot of mature tools: mdbook (used for Rust), Sphinx (used for Python) and Scribble (used for Racket). I don't know of many good options for "slightly bigger than a README" though.