Key System and Cross-References
Document Identification
Each document is identified by a Key - a path-based identifier:
pub struct Key {
pub relative_path: Arc<String>, // e.g., "folder/document"
}Key features:
- Path-based: Hierarchical organization support
- Reference counting: Arc enables efficient cloning
- Extension handling: Automatic .md extension management
- Relative linking: Support for ../parent/document syntax
Reference Types
IWE supports three reference types:
- Regular markdown links:
[text](document.md) - Wiki-style links:
[[document]] - Piped wiki links:
[[document|display text]]
Each reference type is preserved and can be normalized or converted as needed.