diff --git a/docs/api/reference.md b/docs/api/reference.md
index 871d9c6..48d9eb0 100644
--- a/docs/api/reference.md
+++ b/docs/api/reference.md
@@ -1,3 +1,5 @@
 # API Reference
 
-<redoc spec-url="../v1/openapi.json"></redoc>
+```redoc
+spec-url: ../v1/openapi.json
+```
diff --git a/docs/index.md b/docs/index.md
index dfc843a..fd986dc 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -51,7 +51,7 @@ All RDCP-compliant implementations must expose these endpoints:
 
 ## Documentation Structure
 
-- **[API Reference](api/)** - Interactive OpenAPI (v1) with try-it examples
+- **[API Reference](api/index.md)** - Interactive OpenAPI (v1) with try-it examples
 - **[Protocol Specification](rdcp-protocol-specification.md)** - Complete technical specification
 - **[Implementation Guide](rdcp-implementation-guide.md)** - Step-by-step implementation instructions
 - **[Protocol Schemas](protocol-schemas.md)** - JSON schema definitions