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

Но иногда, когда мы получаем контент, который написан на HTML, нам нужно его преобразовать в Markdown, чтобы использовать его в нашем проекте. В этом гайде мы рассмотрим возможность конвертирования HTML в Markdown с помощью Python, используя две библиотеки: html2markdown и markdownify.

html2markdown

Для использования библиотеки html2markdown, мы должны установить ее с помощью следующей команды: pip install html2markdown

Пример:

import html2markdown

html = '''
    <h1>Как конвертировать HTML в Markdown?</h1>
    <p>На самом деле, это несложно благодаря <strong>библиотекам!</strong></p>
    <h2>Импортируем библиотеку</h2>
    <pre><code>import html2markdown</code></pre>
    '''

convertation = html2markdown.convert(html)

print(convertation)

В этом примере мы импортируем библиотеку html2markdown, которая преобразует HTML-строку в Markdown-строку. Мы присваиваем HTML-строку переменной html, а затем применяем функцию convert() библиотеки html2markdown, чтобы преобразовать HTML в Markdown. Наконец, мы выводим результат преобразования в консоль.

Результат:

# Как конвертировать HTML в Markdown?

На самом деле, это несложно благодаря __библиотекам!__

## Импортируем библиотеку

    import html2markdown

markdownify

Для использования библиотеки markdownify, мы должны установить ее с помощью следующей команды: pip install markdownify

В библиотеке markdownify есть ряд дополнительных настроек, которые позволяют настраивать процесс конвертации. Например, можно указать стиль заголовков, тип списков, управлять ссылками и многое другое.

Например, в следующем примере мы указываем стиль заголовков "Setext":

import markdownify 

html = '''
    <h1>Как конвертировать HTML в Markdown?</h1>
    <p>На самом деле, это несложно благодаря <strong>библиотекам!</strong></p>
    <h2>Импортируем библиотеку</h2>
    <pre><code>import markdownify</code></pre>
'''

markdown = markdownify.markdownify(html, heading_style='SETEXT')

print(markdown)

Результат:

Как конвертировать HTML в Markdown?
=====================================

На самом деле, это несложно благодаря **библиотекам!**

Импортируем библиотеку
-----------------------

    import markdownify

Также можно настроить обработку изображений, ссылок и других элементов. Для более подробной информации рекомендуется ознакомиться с документацией библиотеки markdownify.

Заключение

В заключение, мы рассмотрели два способа конвертации HTML в Markdown с помощью Python. Библиотеки html2markdown и markdownify предоставляют удобные инструменты для работы с различными типами контента и позволяют сократить время на создание документации и блогов.