<!-- source-hash: ab6e8805ed4afb72f4daaf8533fb546d -->
Formats a full document path into a human-readable breadcrumb trail, showing only parent folder segments (excluding the filename).

## Key Components

- **`formatRelativePath(fullPath: string): string`** — Strips the `.md` extension, splits on `/`, drops the last segment (filename), then capitalizes and hyphen-decodes each folder name before joining with ` / `.

## Usage Example

```typescript
import { formatRelativePath } from './format-relative-path'

formatRelativePath('openframe-oss-tenant/architecture/api-controllers.md')
// → 'Openframe oss tenant / Architecture'

formatRelativePath('getting-started.md')
// → 'Getting started'

formatRelativePath('')
// → ''
```

## Behavior Notes

| Input | Output |
|---|---|
| Multi-segment path | Parent folders only, title-cased, hyphens → spaces |
| Single segment (no `/`) | That segment formatted (no parent to strip) |
| Empty string | Returns `''` immediately |
| `.md` extension | Stripped before processing |