Советую посмотреть в сторону Swagger и ReDoc.
Если кратко:
всю документацию пишешь в одном json-файле в формате Swagger-OpenAPI.
Затем пишешь коротенькую html, которая подцепляет ReDoc и скармилвает ему твой json. Далее это всё превращается в красивые доки. Пример html:
<!DOCTYPE html>
<html lang="en">
<head>
<title>My API</title>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="robots" content="noindex,nofollow" />
<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
<style>
body {
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<script>
<redoc spec-url="my-api.json"></redoc>
</script>
<script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
</body>
</html>
Средний
