diff --git a/adapters/humachi/humachi_test.go b/adapters/humachi/humachi_test.go
index 9721c669..1fd4341d 100644
--- a/adapters/humachi/humachi_test.go
+++ b/adapters/humachi/humachi_test.go
@@ -322,6 +322,9 @@ func TestChiRouterPrefix(t *testing.T) {
 	mux.Route("/api", func(r chi.Router) {
 		config := huma.DefaultConfig("My API", "1.0.0")
 		config.Servers = []*huma.Server{{URL: "http://localhost:8888/api"}}
+		// config.CreateHooks = []func(huma.Config) huma.Config{
+		// 	huma.DefaultSchemaLinkHook("/api"),
+		// }
 		api = New(r, config)
 	})
 
@@ -350,7 +353,8 @@ func TestChiRouterPrefix(t *testing.T) {
 	// The docs HTML should point to the full URL including base path.
 	resp = tapi.Get("/api/docs")
 	assert.Equal(t, http.StatusOK, resp.Code)
-	assert.Contains(t, resp.Body.String(), "/api/openapi.yaml")
+	// The openapi.yaml should be a relative path.
+	assert.Contains(t, resp.Body.String(), `apiDescriptionUrl="openapi.yaml"`)
 }
 
 // func BenchmarkHumaV1Chi(t *testing.B) {
diff --git a/api.go b/api.go
index e99bc439..ed00a85c 100644
--- a/api.go
+++ b/api.go
@@ -10,7 +10,6 @@ import (
 	"mime/multipart"
 	"net/http"
 	"net/url"
-	"path"
 	"reflect"
 	"regexp"
 	"strings"
@@ -181,6 +180,15 @@ type Config struct {
 	// blank and attach it directly to the router or adapter.
 	DocsPath string
 
+	// DocsAdapter is an optional [Adapter] that will be used to serve the API
+	// documentation. If unset, the main adapter will be used.
+	// Setting this allows you to use a different router or middleware stack for
+	// the documentation.
+	// Note that if this [Adapter] has a different path than the main one, the
+	// default CreateHook set in [DefaultConfig] needs to be modified to account
+	// for it.
+	DocsAdapter Adapter
+
 	// SchemasPath is the path to the API schemas. If set to `/schemas` it will
 	// allow clients to get `/schemas/{schema}` to view the schema in a browser
 	// or for use in editors like VSCode to provide autocomplete & validation.
@@ -362,7 +370,7 @@ func getAPIPrefix(oapi *OpenAPI) string {
 //	config := huma.DefaultConfig("Example API", "1.0.0")
 //	api := huma.NewAPI(config, adapter)
 func NewAPI(config Config, a Adapter) API {
-	for i := 0; i < len(config.CreateHooks); i++ {
+	for i := range config.CreateHooks {
 		config = config.CreateHooks[i](config)
 	}
 
@@ -400,9 +408,14 @@ func NewAPI(config Config, a Adapter) API {
 		newAPI.formatKeys = append(newAPI.formatKeys, k)
 	}
 
+	docsAdapter := newAPI.adapter
+	if config.DocsAdapter != nil {
+		docsAdapter = config.DocsAdapter
+	}
+
 	if config.OpenAPIPath != "" {
 		var specJSON []byte
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.OpenAPIPath + ".json",
 		}, func(ctx Context) {
@@ -413,7 +426,7 @@ func NewAPI(config Config, a Adapter) API {
 			ctx.BodyWriter().Write(specJSON)
 		})
 		var specJSON30 []byte
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.OpenAPIPath + "-3.0.json",
 		}, func(ctx Context) {
@@ -424,7 +437,7 @@ func NewAPI(config Config, a Adapter) API {
 			ctx.BodyWriter().Write(specJSON30)
 		})
 		var specYAML []byte
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.OpenAPIPath + ".yaml",
 		}, func(ctx Context) {
@@ -435,7 +448,7 @@ func NewAPI(config Config, a Adapter) API {
 			ctx.BodyWriter().Write(specYAML)
 		})
 		var specYAML30 []byte
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.OpenAPIPath + "-3.0.yaml",
 		}, func(ctx Context) {
@@ -448,14 +461,10 @@ func NewAPI(config Config, a Adapter) API {
 	}
 
 	if config.DocsPath != "" {
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.DocsPath,
 		}, func(ctx Context) {
-			openAPIPath := config.OpenAPIPath
-			if prefix := getAPIPrefix(newAPI.OpenAPI()); prefix != "" {
-				openAPIPath = path.Join(prefix, openAPIPath)
-			}
 			ctx.SetHeader("Content-Type", "text/html")
 			title := "Elements in HTML"
 			if config.Info != nil && config.Info.Title != "" {
@@ -476,7 +485,7 @@ func NewAPI(config Config, a Adapter) API {
   <body style="height: 100vh;">
 
     <elements-api
-      apiDescriptionUrl="` + openAPIPath + `.yaml"
+      apiDescriptionUrl="` + strings.TrimPrefix(config.OpenAPIPath, "/") + `.yaml"
       router="hash"
       layout="sidebar"
       tryItCredentialsPolicy="same-origin"
@@ -488,7 +497,7 @@ func NewAPI(config Config, a Adapter) API {
 	}
 
 	if config.SchemasPath != "" {
-		a.Handle(&Operation{
+		docsAdapter.Handle(&Operation{
 			Method: http.MethodGet,
 			Path:   config.SchemasPath + "/{schema}",
 		}, func(ctx Context) {
diff --git a/defaults.go b/defaults.go
index 4418c4d1..99c66509 100644
--- a/defaults.go
+++ b/defaults.go
@@ -5,6 +5,9 @@ import (
 	"io"
 )
 
+// DefaultSchemaNamer is the default prefix used to reference schemas in the API spec.
+const DefaultSchemaRefPrefix = "#/components/schemas/"
+
 // DefaultJSONFormat is the default JSON formatter that can be set in the API's
 // `Config.Formats` map. This is used by the `DefaultConfig` function.
 //
@@ -53,10 +56,7 @@ var DefaultFormats = map[string]Format{
 //
 //	import _ "github.com/danielgtaylor/huma/v2/formats/cbor"
 func DefaultConfig(title, version string) Config {
-	schemaPrefix := "#/components/schemas/"
-	schemasPath := "/schemas"
-
-	registry := NewMapRegistry(schemaPrefix, DefaultSchemaNamer)
+	registry := NewMapRegistry(DefaultSchemaRefPrefix, DefaultSchemaNamer)
 
 	return Config{
 		OpenAPI: &OpenAPI{
@@ -71,20 +71,24 @@ func DefaultConfig(title, version string) Config {
 		},
 		OpenAPIPath:   "/openapi",
 		DocsPath:      "/docs",
-		SchemasPath:   schemasPath,
+		SchemasPath:   "/schemas",
 		Formats:       DefaultFormats,
 		DefaultFormat: "application/json",
 		CreateHooks: []func(Config) Config{
-			func(c Config) Config {
-				// Add a link transformer to the API. This adds `Link` headers and
-				// puts `$schema` fields in the response body which point to the JSON
-				// Schema that describes the response structure.
-				// This is a create hook so we get the latest schema path setting.
-				linkTransformer := NewSchemaLinkTransformer(schemaPrefix, c.SchemasPath)
-				c.OpenAPI.OnAddOperation = append(c.OpenAPI.OnAddOperation, linkTransformer.OnAddOperation)
-				c.Transformers = append(c.Transformers, linkTransformer.Transform)
-				return c
-			},
+			DefaultSchemaLinkHook(""), // assume schemas are on mounted the root
 		},
 	}
 }
+
+// DefaultSchemaLinkHook adds a link transformer to the API.
+// This adds `Link` headers and puts `$schema` fields in the response body which
+// point to the JSON Schema that describes the response structure.
+// This is a create hook so we get the latest schema path setting.
+func DefaultSchemaLinkHook(schemaPathPrefix string) func(c Config) Config {
+	return func(c Config) Config {
+		linkTransformer := NewSchemaLinkTransformer(schemaPathPrefix, c.SchemasPath)
+		c.OpenAPI.OnAddOperation = append(c.OpenAPI.OnAddOperation, linkTransformer.OnAddOperation)
+		c.Transformers = append(c.Transformers, linkTransformer.Transform)
+		return c
+	}
+}
diff --git a/transforms.go b/transforms.go
index 292cdf27..d092bc28 100644
--- a/transforms.go
+++ b/transforms.go
@@ -20,7 +20,7 @@ type schemaField struct {
 // as-you-type validation & completion of HTTP resources in editors like
 // VSCode.
 type SchemaLinkTransformer struct {
-	prefix      string
+	apiPrefix   string
 	schemasPath string
 	types       map[any]struct {
 		t      reflect.Type
@@ -36,9 +36,9 @@ type SchemaLinkTransformer struct {
 // to understand the structure of the response and enables things like
 // as-you-type validation & completion of HTTP resources in editors like
 // VSCode.
-func NewSchemaLinkTransformer(prefix, schemasPath string) *SchemaLinkTransformer {
+func NewSchemaLinkTransformer(apiPrefix, schemasPath string) *SchemaLinkTransformer {
 	return &SchemaLinkTransformer{
-		prefix:      prefix,
+		apiPrefix:   apiPrefix,
 		schemasPath: schemasPath,
 		types: map[any]struct {
 			t      reflect.Type
@@ -94,8 +94,10 @@ func (t *SchemaLinkTransformer) OnAddOperation(oapi *OpenAPI, op *Operation) {
 	// Figure out if there should be a base path prefix. This might be set when
 	// using a sub-router / group or if the gateway consumes a part of the path.
 	schemasPath := t.schemasPath
-	if prefix := getAPIPrefix(oapi); prefix != "" {
-		schemasPath = path.Join(prefix, schemasPath)
+	if apiPrefix := getAPIPrefix(oapi); apiPrefix != "" {
+		schemasPath = path.Join(apiPrefix, schemasPath)
+	} else if t.apiPrefix != "" {
+		schemasPath = path.Join(t.apiPrefix, schemasPath)
 	}
 
 	registry := oapi.Components.Schemas