Jak przekonwertować RST na MD
- Dodaj swój plik .RST - przeciągnij go do powyższego pola lub kliknij, aby przeglądać.
- Przekonwertuj go na format .MD w kilka sekund.
- Pobierz swój nowy plik .MD.
Czego się spodziewać
- Nagłówki, listy punktowane, linki i kod wewnątrz wiersza konwertują się czysto; dyrektywy RST (
.. note::,.. code-block::) i role (:ref:,:func:) są pomijane lub przybliżane - sprawdź każdą dyrektywę po konwersji. .. toctree::nie jest zachowywane; musisz ręcznie odbudować spis treści po konwersji.- Aby celować w konkretną odmianę Markdown, przekaż
-t gfm(GitHub Flavored Markdown) lub-t commonmarkdo Pandoc.
Najczęściej zadawane pytania
Czy konwersja z RST na Markdown jest bezstratna?
Nie. Podstawowa zawartość - nagłówki, listy, linki, kod wewnątrz wiersza - zostaje przeniesiona, ale dyrektywy i role RST nie mają odpowiedników w Markdown i zostają utracone. Ręczne czyszczenie jest normalnym etapem.
Jaka jest główna różnica między RST a Markdown?
Oba są językami znaczników tekstu jawnego, ale RST ma bogatszy system dyrektyw i ról zaprojektowany dla ustrukturyzowanej dokumentacji (Sphinx). Markdown jest prostszy i szerzej stosowany w plikach README i ogólnych notatkach.
Jak przekonwertować cały folder plików RST?
Pandoc obsługuje jeden plik na polecenie; w systemie Linux lub macOS użyj pętli:
for f in *.rst; do pandoc "$f" -o "${f%.rst}.md"; done.Jak zachować działanie dokumentacji Sphinx po konwersji na Markdown?
Użyj MyST Markdown zamiast zwykłego Markdown - MyST obsługuje dyrektywy i role w stylu RST, dzięki czemu kompilacja Sphinx będzie nadal działać.
