import TurndownService from 'turndown';
/**
 * Options for the turndown markdown conversion.
 * Extends the native TurndownService options.
 */
export type TurndownOptions = TurndownService.Options;
/**
 * Converts HTML text to Markdown.
 *
 * @param html - The HTML content to convert to Markdown
 * @param options - Optional configuration for the Turndown conversion
 * @returns The converted Markdown text
 * @throws {TurndownError} When conversion fails
 *
 * @example
 * ```typescript
 * try {
 *   const markdown = turndown('<h1>Hello World</h1><p>This is a paragraph</p>');
 *   console.log(markdown);
 * } catch (error) {
 *   console.error('Conversion failed:', error.message);
 * }
 * ```
 */
export declare function turndown(html: string, options?: TurndownOptions): string;