Best practices for private documentation indexing?

Only public URLs are available currently. What you can do is just like you say, convert these to markdown then store them in a folder somwhere in you codebase.

Then it’s very easy to just include that in the context by writing @docs/your-private-doc.md in the prompt.

Would that work for you?