Rozwiązywanie problemów z blokami kodu Markdown w potokach tłumaczenia LLM

Dokument Markdown może zostać uszkodzony, zanim jego przetłumaczona treść będzie użyteczna, jeśli opakowanie transportowe również jest ogrodzonym blokiem Markdown. Łatwo przeoczyć ten błąd: wewnętrzne ogrodzenie kodu może zostać zinterpretowane jako koniec zewnętrznego bloku, a pozostała część dokumentu znajdzie się poza blokiem kodu. Ten przewodnik przedstawia zasady dotyczące ograniczników oraz bezpieczniejsze sposoby reprezentowania zagnieżdżonego Markdown.

1. Rozpoznaj przedwczesne zamknięcie

Ogrodzony blok kodu Markdown może zostać zamknięty przedwcześnie, gdy jego treść zawiera ogrodzenie o tej samej długości ogranicznika. Wszystko po tym wewnętrznym ogrodzeniu zostaje wtedy sparsowane poza blokiem kodu.

Na przykład blok zewnętrzny otwarty trzema backtickami nie może bezpiecznie zawierać kolejnego ogrodzenia złożonego z trzech backticków jako zwykłej treści. Wewnętrzne ogrodzenie pasuje do zewnętrznego ogranicznika i może zostać potraktowane jako jego ogranicznik zamykający.

To pierwszy objaw, który należy sprawdzić: dokument wygląda poprawnie do napotkania osadzonego ogrodzenia kodu, a pozostały tekst nie jest już traktowany jako kod.

2. Sprawdź zasady dotyczące ogrodzeń

Ogrodzone bloki kodu Markdown mogą używać co najmniej trzech kolejnych backticków lub tyld jako ogrodzenia.

Ogranicznik zamykający musi używać tego samego znaku ogrodzenia co ogranicznik otwierający. Musi też być co najmniej tak długi jak ogranicznik otwierający.

To dwa osobne warunki. Dłuższy ciąg backticków nie zamyka bloku otwartego tyldami, a krótszy ciąg nie zamyka bloku otwartego dłuższym ciągiem tego samego znaku.

3. Użyj dłuższego zewnętrznego ogrodzenia z backticków

Jeśli dokument zawiera ogrodzenie złożone z trzech backticków, opakuj je w zewnętrzne ogrodzenie złożone z co najmniej czterech backticków. Zewnętrzne ogrodzenie jest wtedy dłuższe od wewnętrznego, więc wewnętrzna sekwencja trzech backticków może pozostać treścią. Jeśli dokument zawiera dłuższy ciąg backticków, zewnętrzne ogrodzenie również musi być od niego dłuższe.

Najważniejsza jest różnica długości:

• wewnętrzne ogrodzenie: trzy backticki
• zewnętrzne ogrodzenie: cztery lub więcej backticków

Zewnętrzny ogranicznik trzeba wybrać na podstawie treści, którą otacza. Jeśli treść zawiera dłuższy ciąg, odpowiednio zwiększ długość zewnętrznego ogrodzenia.

4. Użyj tyld, gdy treść zawiera backticki

Ogrodzenia z tyld są alternatywą, gdy treść zawiera backticki. Blok otwarty tyldami musi również zostać zamknięty tyldami.

Dzięki temu opakowanie używa innego znaku ogrodzenia niż znajdujące się w dokumencie ogrodzenia z backticków. Nie znosi to zasady zgodności znaków: otwierające i zamykające ograniczniki zewnętrznego bloku nadal muszą używać tyld.

Wybierz jedną strategię ograniczników dla opakowania i zachowaj spójność znaków otwierających oraz zamykających.

5. Zachowaj dosłowną treść ogrodzenia

Tekst wewnątrz ogrodzonego bloku kodu jest traktowany jako dosłowna treść, a nie parsowany jako Markdown. Znaki takie jak gwiazdki, podkreślenia i pionowe kreski pojawiają się więc w bloku dosłownie.

Dlatego granica ogrodzenia ma znaczenie. Dopóki treść pozostaje wewnątrz bloku, te znaki pozostają jego treścią kodową. Jeśli ogranicznik zamknie blok przedwcześnie, późniejszy tekst nie jest już chroniony przez zasady dotyczące ogrodzonego kodu.

6. Zachowaj informację o języku

Ogrodzony blok kodu może zawierać opcjonalny ciąg informacyjny po otwierającym ogrodzeniu. Pierwsze słowo tego ciągu może wskazywać język używany do podświetlania składni.

Podczas opakowywania lub ekstrakcji dokumentu zachowaj ten ciąg przy otwierającym ogrodzeniu. Opakowanie zmienia granicę wokół dokumentu, ale nie zastępuje opcjonalnej informacji przypisanej do wewnętrznego bloku kodu.

7. Oddziel tekst czatu od Canvas i Artifacts

Canvas i Artifacts to interfejsy panelu bocznego, które oddzielają wygenerowaną treść od głównego przebiegu czatu. Wyświetlana tam treść różni się od zwykłego tekstu czatu.

Podczas ekstrakcji nie traktuj treści panelu bocznego tak, jakby automatycznie była tym samym tekstem co główna rozmowa. Zanim użyjesz wyniku jako treści Markdown, ustal, w którym interfejsie znajduje się wygenerowany dokument.

Co sprawdzić po naprawieniu wyniku

Najpierw sprawdź zewnętrzny ogranicznik. Musi mieć prawidłową długość, a jego ogranicznik zamykający musi używać tego samego znaku i być co najmniej tak długi jak ogranicznik otwierający. Następnie sprawdź, czy dokument zawiera wewnętrzne ogrodzenie równe długością opakowaniu lub od niego dłuższe. Jeśli tak, użyj dłuższego zewnętrznego ogrodzenia albo opakowania z tyld.

Na koniec sprawdź miejsce ekstrakcji. Tekst z Canvas lub Artifacts należy do interfejsu panelu bocznego, a nie do zwykłego przebiegu czatu. Zachowanie tego rozróżnienia zapobiega pomyleniu wyniku z panelu bocznego z tekstem czatu.