# Basic Cross References

Basic cross-reference processing for internal section references using the
|reference| syntax.

## 📋 What this example demonstrates

- Cross-reference syntax |ref|
- Internal section references
- Section number resolution
- Reference processing

## 📁 Files

- **agreement.md** - Document with cross-references
- **metadata.yaml** - Metadata values for substitution
- **agreement.output.md** - Document with resolved references
- **agreement.output.html** - HTML with formatted values

## 🚀 Usage

```bash
./run.sh
```

## 🔍 Key features shown

1. **Reference Syntax**: Using |reference| for internal section references
2. **Section Linking**: Automatic linking between document sections
3. **Number Resolution**: Replacement of references with section numbers and
   titles
4. **Hierarchical Navigation**: Cross-referencing across different header levels

## 💡 Learn more

- [Cross-References Guide](../../../docs/cross-references.md)
- [Metadata Integration](../../../docs/metadata.md)