How to have multiple markdown files

[amitavaghosh1]

So I had this OpenAPI json files generated using grpc_gateway.

find . -type f -name '*.proto' | xargs -I % protoc --go_out=paths=import:../ -I. --grpc-gateway_out ../ --swagger_out=:swagger %

So after this I used widdershins to generate the .md file

find ./swagger -type f -name '*.json' -maxdepth 3 | grep protos | xargs -I {} bash -c 'widdershins --language_tabs 'go:Go' 'shell:curl' --summary {} -o "docs/$(basename {}).md"'

tree -L 2
.
├── Makefile
├── docs
 │   ├── jet.swagger.json.md
 │  └── pilot.swagger.json.md
├── go.mod
├── go.sum
├── slatebuild
 │   └── slate
├── swagger
 │   ├── google
 │   ├── jets
 │   └── pilots

But after I put the generated markdown files inside the source/ directory. cp docs/*.md slatebuild/slate/source/ and I run
docker run --rm --name slate -v $(pwd)/build:/srv/slate/build -v $(pwd)/source:/srv/slate/source slatedocs/slate build I generates only the kittens index.html file.

I put these files in includes folder, and then again typed them out in include in index.html.rb . This works. But this there a better way to do this?