import type { MarkdownReaderDependencies } from "./document.js";
export interface ReadMarkdownParams {
    file: string;
    /**
     * Limit the table of contents to <n> levels of numbered sections. Levels are
     * counted from the shallowest numbered heading, not from the raw heading
     * level, so depth 1 lists the top-level sections of a document whose body
     * starts at `##` under a single `#` title.
     */
    depth?: number;
}
export interface TocEntry {
    depth: number;
    number: string | null;
    title: string;
}
export interface ReadMarkdownResult {
    file: string;
    frontmatter: Record<string, unknown>;
    sections: TocEntry[];
}
export declare function createReadMarkdown(dependencies?: MarkdownReaderDependencies): (params: ReadMarkdownParams) => Promise<ReadMarkdownResult>;
export declare const readMarkdown: (params: ReadMarkdownParams) => Promise<ReadMarkdownResult>;