Этот конвертер RST в Markdown переводит reStructuredText (Sphinx, docutils, README с PyPI) в GitHub Flavored Markdown: разделы, блоки кода, сеточные и простые таблицы, admonition-блоки, сноски и ссылки. Вставьте текст .rst и скопируйте Markdown.
Обновлено:
Как это работает
Вставьте RST
Вставьте README.rst или страницу Sphinx, откройте файл .rst или нажмите «Загрузить пример».
Настройте Markdown
Admonition-блоки как уведомления GitHub или цитаты, маркер списка, курсив и ограничитель кода.
Скопируйте Markdown
Используйте его на GitHub, в MkDocs, Docusaurus или при переходе на MyST — результат видно во вкладке «Просмотр».
Возможности
Уровни разделов по подчеркиванию
Уровни определяются порядком, в котором впервые встречаются стили подчеркивания и надчеркивания, — ровно так, как это делает docutils.
Все виды блоков
Директивы code-block, code и sourcecode, литеральные блоки после ::, блоки doctest, line blocks и цитаты с указанием автора.
Таблицы
Сеточные таблицы, простые таблицы (в том числе со строками продолжения), директивы list-table и csv-table становятся таблицами Markdown.
Ссылки разрешаются
Именованные и анонимные цели гиперссылок, встроенные URI, подстановки с изображениями, нумерованные и автонумерованные сноски.
Ограничения и конфиденциальность
Файлы до 10 MB. Тексты больше 256 KB конвертируются в фоновом потоке (Web Worker). Ничего не загружается на сервер: конвертация идет в вашем браузере, а «Открыть по ссылке» скачивает файл напрямую с указанного адреса. Подробнее — на странице о конфиденциальности.
Ограничения
Директивы include и перекрестные ссылки Sphinx требуют всего проекта и не разрешаются. Из многострочной шапки таблицы заголовком Markdown становится только первая строка. Списки полей (field lists) превращаются в жирные термины с текстом после них.
Частые вопросы
Как конвертировать RST в Markdown без pandoc?
Вставьте reStructuredText сюда и скопируйте результат — устанавливать ничего не нужно.
Что происходит с директивами Sphinx вроде toctree?
toctree, autodoc и include требуют всего проекта, поэтому они пропускаются, а в предупреждении названа каждая такая директива.
Поддерживаются ли admonition-блоки?
note, tip, important, warning, caution, danger, hint, seealso и универсальный admonition превращаются в уведомления GitHub или цитаты.
Что с ролями :ref: и :doc:?
Перекрестные ссылки заменяются своим текстом, а :code:, :math:, :sup: и :sub: сохраняют смысл.
Как перевести README.rst в README.md для GitHub?
Откройте README.rst, проверьте результат во вкладке «Просмотр» и скачайте файл .md — его можно положить в репозиторий вместо старого README.
Можно ли конвертировать Markdown в RST?
Да, с помощью конвертера Markdown → RST — ссылка на него над результатом.