parser

type Document struct {
	Meta     Meta
	Title    string
	Sections []Section
}

type Meta struct {
	Title       string `yaml:"title"`
	Description string `yaml:"description"`
	Timestamp   string `yaml:"timestamp"`
	// Date is the documented alias for Timestamp; read it via Timestamp.
	Date string     `yaml:"date"`
	Tags stringList `yaml:"tags"`
}

type Parser interface {
	Parse(path string, data []byte) (*Document, error)
}

type Section struct {
	HeadingPath string // e.g. "Introduction > Background"
	Text        string
	Ordinal     int // byte offset where this section starts
}