html = $html; } /** * Run the conversion */ public function convert(): string { $converter = new HtmlConverter($this->getConverterEnvironment()); $html = $this->prepareHtml($this->html); return $converter->convert($html); } /** * Run any pre-processing to the HTML to clean it up manually before conversion. */ protected function prepareHtml(string $html): string { // Carriage returns can cause whitespace issues in output $html = str_replace("\r\n", "\n", $html); // Attributes on the pre tag can cause issues with conversion return preg_replace('/
/', '
', $html);
    }

    /**
     * Get the HTML to Markdown customized environment.
     * Extends the default provided environment with some BookStack specific tweaks.
     */
    protected function getConverterEnvironment(): Environment
    {
        $environment = new Environment(['header_style' => 'atx']);

        $environment->addConverter(new BlockquoteConverter());
        $environment->addConverter(new CodeConverter());
        $environment->addConverter(new CommentConverter());
        $environment->addConverter(new DivConverter());
        $environment->addConverter(new EmphasisConverter());
        $environment->addConverter(new HardBreakConverter());
        $environment->addConverter(new HeaderConverter());
        $environment->addConverter(new HorizontalRuleConverter());
        $environment->addConverter(new ImageConverter());
        $environment->addConverter(new LinkConverter());
        $environment->addConverter(new ListBlockConverter());
        $environment->addConverter(new ListItemConverter());
        $environment->addConverter(new CustomParagraphConverter());
        $environment->addConverter(new PreformattedConverter());
        $environment->addConverter(new TextConverter());

        return $environment;
    }
}