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