Конвертация HTML в Markdown на Java

Конвертация HTML в Markdown с помощью Java API

Aspose.HTML for Java преобразует HTML в Markdown методом Converter.convertHTML() . Передайте исходный HTML, создайте MarkdownSaveOptions и укажите путь к файлу .md. Конвертер сопоставит поддерживаемые заголовки, абзацы, ссылки, списки, выделение и другие элементы с синтаксисом Markdown.

Экспорт содержимого HTML в MD-файл

В примере document.html преобразуется со стандартными настройками Markdown, а текстовый результат сохраняется в output.md.

import com.aspose.html.converters.Converter;
import com.aspose.html.saving.MarkdownSaveOptions;

// Create the Markdown save options
MarkdownSaveOptions options = new MarkdownSaveOptions();

// Convert HTML to Markdown
Converter.convertHTML("document.html", options, "output.md");

Проверка конвертации HTML в Markdown онлайн

Загрузите HTML-файл или укажите его URL и проверьте созданный Markdown, прежде чем добавлять конвертацию в процесс обработки содержимого на Java.

Как преобразовать HTML в Markdown на Java

1. Добавьте Aspose.HTML for Java в проект.
2. Подготовьте HTML-файл или другой поддерживаемый источник HTML.
3. Создайте MarkdownSaveOptions с требуемым набором элементов и средством форматирования.
4. Вызовите Converter.convertHTML() , передав источник, настройки и путь к файлу .md.

Выбор элементов и форматирования Markdown

Класс MarkdownSaveOptions определяет, какие HTML-элементы преобразуются, какой стиль Markdown применяется, как обрабатываются ресурсы и требуется ли совместимость с Git-стилем Markdown. Не для каждой HTML-разметки или интерактивного элемента существует прямой аналог в Markdown. Сложная структура может быть упрощена или сохранена как встроенный HTML в зависимости от выбранных параметров.

Дополнительные сведения приведены в руководстве Convert HTML to Markdown in Java и в справочнике API MarkdownSaveOptions .

Установка Aspose.HTML for Java

Добавьте Aspose.HTML for Java из официального репозитория Aspose. Замените ASPOSE_HTML_VERSION точным номером версии со страницы выпусков Aspose.HTML for Java , затем перезагрузите или пересоберите проект, чтобы система зависимостей загрузила библиотеку.

Добавьте репозиторий и зависимость в проект Maven:

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-html</artifactId>
        <version>ASPOSE_HTML_VERSION</version>
    </dependency>
</dependencies>

Добавьте репозиторий и зависимость в проект Gradle:

repositories {
    maven {
        url = uri('https://releases.aspose.com/java/repo/')
    }
}
dependencies {
    implementation 'com.aspose:aspose-html:ASPOSE_HTML_VERSION'
}

Используйте версию JDK, совместимую с выбранным выпуском библиотеки. Инструкции по установке JAR вручную, настройке Kotlin DSL, обновлению и устранению проблем с зависимостями приведены в руководстве Установка Aspose.HTML for Java .

Вопросы о конвертации HTML в Markdown

1. Какие HTML-элементы можно преобразовать в Markdown?

Для распространённых структурных и строчных элементов, включая заголовки, абзацы, ссылки, списки и выделение, существуют аналоги в Markdown. Набор преобразуемых элементов определяется включёнными MarkdownFeatures.

2. Можно ли создать Markdown в стиле Git из HTML?

Да. Если результат должен соответствовать поддерживаемому Git-совместимому набору возможностей Markdown, используйте готовые настройки, возвращаемые методом MarkdownSaveOptions.getGit().

3. Почему результат Markdown может отличаться от внешнего вида HTML-страницы?

Markdown описывает структуру документа, а не браузерную разметку. CSS, скрипты, формы, позиционированные элементы и другое оформление не имеют прямых аналогов в Markdown и могут быть упрощены или пропущены.

4. Можно ли бесплатно преобразовать HTML в Markdown онлайн?

Да. Для разовой операции используйте бесплатный онлайн-конвертер HTML в Markdown . Для повторяемых процессов миграции и публикации используйте Aspose.HTML for Java.