pip install hf-doc-builder==0.4.0 watchdog --upgrade

doc-builder preview endpoints docs/source/ --not_python_module

doc-builder build endpoints docs/source/ --build_dir build/ --not_python_module

Adding images/assets is only possible through https:// links meaning you need to use https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/ prefix.

example

<img src="https://raw.githubusercontent.com/huggingface/hf-endpoints-documentation/main/assets/0_login.png" alt="Login" />

1. Copy openapi spec from https://api.endpoints.huggingface.cloud/api-doc/openapi.json
2. create markdown widdershins --environment env.json openapi.json -o myOutput.md
3. copy into api_reference.mdx