Цей конвертер Markdown в RST перетворює текст на reStructuredText для Sphinx, Read the Docs і PyPI: заголовки з підкресленням, директиви code-block, сіткові таблиці, блоки-примітки (admonitions) і виноски. Вставте README.md і скопіюйте .rst.
Оновлено:
Як це працює
Вставте Markdown
Вставте README чи сторінку документації, відкрийте файл .md або натисніть «Відкрити приклад».
Виберіть правила запису
Символи підкреслення заголовків, директиву для коду, стиль таблиць і стиль посилань.
Використайте .rst
Завантажте README.rst або вставте текст у свій проєкт Sphinx.
Можливості
Коректна структура розділів
RST визначає рівні за порядком стилів підкреслення, тому пропущені рівні Markdown ущільнюються — так не виникає помилки «Title level inconsistent».
Директиви, а не обхідні шляхи
Код стає .. code-block:: python, примітки — .. note:: чи .. warning::, формули — .. math::.
Три стилі таблиць
Сіткові таблиці (grid), прості таблиці (simple) або директива list-table, яку найлегше редагувати.
Правила вбудованої розмітки враховано
Там, де RST потребує пробілу навколо **жирного** чи `посилань`__, вставляються екрановані пробіли.
Обмеження та конфіденційність
Розмір файлу — до 10 MB. Тексти, більші за 256 KB, конвертуються у фоновому потоці (Web Worker), тому сторінка не зависає. Нічого не надсилається на сервер: усе обробляється в браузері, а «Відкрити за URL» отримує файл безпосередньо з указаної адреси. Докладніше — на сторінці конфіденційності.
Відмінності, які варто пам’ятати
У reStructuredText немає закреслення й підкреслення — такий текст залишається звичайним. Примусові розриви рядків стають блоками рядків (рядки з |). Розділювач (––) не може починати чи завершувати документ, тому в цих місцях його прибрано. Сіткові та прості таблиці не мають вирівнювання стовпців.
Часті запитання
Як конвертувати README.md у README.rst?
Відкрийте тут README.md і завантажте результат як README.rst. Перегляньте попередження: там перелічено те, чого RST не вміє передати.
Чи потрібен PyPI формат RST?
Ні, PyPI відображає й Markdown, але проєкти Sphinx і чимало старіших інструментів очікують reStructuredText.
Чому зникає жирний шрифт усередині посилання?
reStructuredText не підтримує вкладеної вбудованої розмітки. Текст посилання зберігається, а внутрішнє форматування прибирається з попередженням.
Як записуються зображення всередині тексту?
Через підстановки: |name| у тексті та визначення .. |name| image:: у кінці.
Чи можна перетворити RST назад у Markdown?
Так, за допомогою конвертера RST → Markdown, посилання на який є над результатом.
Чи надсилаються файли на сервер?
Ні. Конвертер безкоштовний, працює без реєстрації й обробляє все у вашому браузері.