> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/pl/artykuly-szczegolowe/32-markdown-into-latex-with-style.md). # Markdown do LaTeX-a ze стилем **Aktualizacja po publikacji** (13 maja 2017): Jesteśmy wdzięczni Vítowi Novotnému, autorowi i opiekunowi `markdown` pakietu, za napisanie do nas z kilkoma pomocnymi uwagami dotyczącymi oryginalnego artykułu. Z przyjemnością publikujemy tę zaktualizowaną wersję, która uwzględnia jego rady i sugestie. ### Wstęp Jakiś czas temu cieszyliśmy się z wydania [`pakietu markdown`](http://www.ctan.org/pkg/markdown) który umożliwił pisanie składni markdown w dokumentach LaTeX — i uczciliśmy to artykułem zatytułowanym [Jak pisać w Markdown w Overleaf](/latex/pl/artykuly-szczegolowe/30-how-to-write-in-markdown-on-overleaf.md) którego celem było zademonstrowanie niektórych obsługiwanych elementów składni. **Pamiętaj**: Będziesz musiał skompilować swoje `.tex` pliki z `--shell-escape` opcją, aby działało to w lokalnych instalacjach LaTeX-a — Overleaf robi to za Ciebie (automatycznie). Pamiętaj, że większość portali do zgłaszania artykułów nie włącza `--shell-escape`— chyba że możesz przesłać tylko wynikowy plik PDF swojego manuskryptu, pliki LaTeX zawierające markdown mogą nie skompilować się poprawnie po przetworzeniu przez system zgłoszeniowy wydawcy. Jednym z pomysłów zasugerowanych w [wcześniejszym artykule](/latex/pl/artykuly-szczegolowe/30-how-to-write-in-markdown-on-overleaf.md) jest to, że połączenie markdown i LaTeX-a pozwala na wspaniałe rozdzielenie treści i stylu. Autorzy (zwłaszcza ci już zaznajomieni z markdown) mieliby do dyspozycji znacznie zwięźlejszą składnię (z pewnymi zastrzeżeniami), a jednocześnie nadal mieliby dostęp do wszystkich zalet pakietów i szablonów LaTeX-a, które zajmują się stylizacją i formatowaniem. To [wcześniejszym artykule](/latex/pl/artykuly-szczegolowe/30-how-to-write-in-markdown-on-overleaf.md) pokazał kilka przykładów użycia markdown w [prezentacjach Beamera](https://www.overleaf.com/read/dnrwnjrpjjhw) i [plakatach](https://www.overleaf.com/read/jtbgmmgqrqmh): dziś przyjrzymy się jeszcze zabawniejszym i bardziej ekscytującym możliwościom stylizacji! ### Używanie markdown w stylowanych szablonach LaTeX-a Poza powyższymi przykładami możesz używać markdown w niemal wszystkich szablonach. Oto kilka krótkich przykładów: * Ta [pomarańczowa książka Legrange'a](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) szablon * Ta [materiał inspirowany Tufte'em](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) szablon * Ten [bardzo ładny szablon artykułu](https://www.overleaf.com/read/xfsrpsmdtqvt) autorstwa Thiago Możesz zauważyć, że dwa z nich to szablony artykułów, a jeden to szablon książki. Pakiet [`pakietu markdown`](http://www.ctan.org/pkg/markdown) sprawdza, czy `\\chapter` polecenie jest dostępne do użycia w danym dokumencie LaTeX i sprawi, że nagłówek pierwszego poziomu `markdown` linia zostanie wyrenderowana jako `\\chapter` lub `\section` odpowiednio. ### Naprawdę szybkie materiały: markdown + PocketMod Od momentu, gdy po raz pierwszy poznałem markdown, wydał mi się on szybkim i wygodnym sposobem robienia notatek: odzwierciedla to, jak mógłbym bazgrać notatki na skrawkach papieru lub karteczkach samoprzylepnych — zwłaszcza przy składni list wypunktowanych i numerowanych. Kiedy po raz pierwszy stworzyłem [szablon PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) w 2015 roku, bardzo pragnąłem sposobu na pisanie markdown w LaTeX-u, aby móc tworzyć PocketMody *z* markdown, ponieważ wydawało się to… odpowiednie. Zapisywanie notatek prostą składnią w małych składanych broszurkach, ale z ładną typografią — niektórzy nazywają PocketMody „zinami”, ponieważ są to małe 8-stronicowe broszurki, które można zrobić z jednej kartki papieru A4. I rzeczywiście było to możliwe! Dzięki temu dość łatwo można szybko przygotować [mini-broszurkę z tygodniowym planerem](https://www.overleaf.com/read/zfzcxygqwqsq) albo małą [książeczkę obrazkową](https://www.overleaf.com/read/rppnsfgnrhsf). Tak, moja córka była rozbawiona, widząc książeczkę zrobioną z jej własnych rysunków… cóż, przez całe 10 minut! Pakiet [`pakietu markdown`](http://www.ctan.org/pkg/markdown) pozwala dostosować sposób, w jaki każda składnia markdown jest renderowana do LaTeX-a, więc przedefiniowałem standardową `![](img_file "caption")` składnię, aby umieścić podpis pod plikiem obrazu (bez prefiksu „Figure” ani numeracji), a następnie wstawiłem podział strony. To jeszcze bardziej ułatwia tworzenie książeczki obrazkowej. Oto film pokazujący, jak złożyć broszurkę: {% embed url="" %} ### Proste książeczki z przepisami Kiedy się nad tym zastanowić, przepis składa się z list: listy składników, listy instrukcji przygotowania lub gotowania, a może listy uwag (czas gotowania, liczba porcji itd.). Zamiast więc pisać tak: ```latex \begin{enumerate} \item Najpierw zrób to \item Potem zrób tamto ... \end{enumerate} ``` Zdecydowanie doceniłbym możliwość zapisania tego tak: ``` #. Najpierw zrób to #. Potem zrób tamto ``` I podobnie dla składników: ``` - 2 jajka - szczypta soli ``` A więc, aby łatwo przygotować szybki przepis, możemy napisać tak: ``` # Jajecznica Czas gotowania : 5 minut Porcje : 1 ## Składniki - 4 jajka - 1 łyżeczka masła - 1/4 szklanki mleka - sól, pieprz (do smaku) ## Instrukcje #. Ubij jajka, mleko... #. Podgrzej masło na patelni... #. ... ``` Hmm, to wygląda obiecująco. Kilkoro z nas w Overleaf (i nasze rodziny) dorzuciło swoje ulubione szybkie przepisy (idealne dla osób gotujących po raz pierwszy) i przygotowałem (przepraszam za grę słów) [szablon szybkiego przepisu](https://www.overleaf.com/read/gscqdhnwzsfg) który można pisać w markdown *i* i zamienić w mini-broszurkę. [![A recipe booklet produced on Overleaf using markdown](/files/816512519891b80c1e4750aa42cfcdac9e84b7ae)](https://www.overleaf.com/read/gscqdhnwzsfg) Teraz czas na odrobinę zabawy. Pod maską to nadal LaTeX, więc możemy nadal stylizować różne elementy — nagłówki sekcji, listy wypunktowane, czcionki i tak dalej — korzystając ze zwykłego zestawu sztuczek LaTeX-a. To wtedy poniosło mnie trochę i wymyśliłem *trzy* „motywy” dla `klasy simple-recipe` ! ### Bonus 1: Kilka zastrzeżeń przy korzystaniu z pakietu markdown * SyncTeX nie będzie działać całkiem poprawnie. W Overleaf oznacza to, że operacje „pozycja w podglądzie” oraz „kliknij w podglądzie, aby przejść do źródła” nie będą działać w `markdown` obszarach. * `\\` traci swoje zwykłe znaczenie: standardowy „dwie spacje, po których następuje nowa linia” `markdown` trik nie działa tutaj, ponieważ końcowe spacje zostaną usunięte przez parser Lua, jak opisano w [`markdown` dokumentacja pakietu](http://texdoc.net/pkg/markdown). `\newline` będzie jednak działać. * Uważaj na wiele znaków podkreślenia w tej samej linii — może to stanowić problem, jeśli: * pracujesz z wieloma indeksami dolnymi w równaniach (wskazówka: w takich przypadkach wyjdź z `markdown` środowiska); * lubisz używać podkreśleń w kluczach BibTeX. Możesz ustawić `underscores=false` w najnowszych `pakietu markdown` plikach, aby podkreślenia indeksu dolnego działały, ale nadal nie będzie to działać z podkreśleniami w kluczach BibTeX. **Aktualizacja** (13 maja 2017): Podkreślenia w kluczach BibTeX będą działać z `markdown` od wersji v2.5.2 wzwyż — dzięki, Vít! * Będziesz mieć pewne trudności z wyświetleniem dosłownego znaku hash (#), ponieważ nawet `\#` to nie zadziała! Zazwyczaj definiuję nowe polecenie i używam go zamiast tego. ### Bonus 2: Nowe funkcje w zaktualizowanym pakiecie markdown `markdown` Wersja v2.4 i nowsze dodały obsługę kilku naprawdę fajnych elementów składni: * **Składnia przypisów dolnych w linii**: `...^[to jest przypis dolny]` (wymaga opcji `inlineFootnotes` ) * **Cytowania:**`[@smith1990]` (wymaga opcji `cytowania` opcji; uważaj też na podkreślenia w kluczach BibTeX!) * **Blok kodu**: Możesz użyć albo tyld `~` albo backticków `` ` `` jako ogranicznika. ``` ~~~~ int main() { cout << "Witaj, świecie!"; return 0; } ~~~~ ``` Jeśli chcesz korzystać z tych nowych funkcji, koniecznie prześlij zaktualizowane wersje `markdown.lua`, `markdown.tex` i `markdown.sty` do swojego projektu — albo możesz po prostu utworzyć nowy projekt na podstawie [tego szablonu](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/pl/artykuly-szczegolowe/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.