> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Jak pisać w Markdown w Overleaf
**Aktualizacja po publikacji** (dodano 13 maja 2017): Jesteśmy wdzięczni Vítowi Novotnému, autorowi/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 i zawiera jego rady oraz sugestie.
### Hę, co?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) to lekki język znaczników (łapiesz? 😉), który pozwala zapisać coś w zwykłym tekście za pomocą kilku *bardzo* prostych reguł, a następnie przekształcić to w sformatowane wyniki, np. HTML. Jest bardzo popularny wśród twórców oprogramowania i programistów właśnie ze względu na swoją prostotę (a dodałbym jeszcze, że jest też idealny do robienia notatek!).
Na przykład, aby napisać szybką listę zakupów:
```
# Lista zakupów
*Pamiętaj*, aby podczas nadchodzących [promocji](http://acme-marg.com) zgarnąć tyle, ile tylko się da!
## Jedzenie
- pieczona fasolka
- spaghetti
## Artykuły papiernicze
- notes
- ołówki
```
A jako wynik HTML otrzymasz to, używając narzędzia takiego jak [pandoc](http://pandoc.org/):
```html
Lista zakupów
Pamiętaj, aby podczas nadchodzących promocji zgarnąć tyle, ile tylko się da!
Jedzenie
- pieczona fasolka
- spaghetti
Artykuły papiernicze
```
Ładnie i prosto! Inną składnię dla Markdown znajdziesz [tutaj](https://daringfireball.net/projects/markdown/syntax).
### Więc co to dla mnie oznacza?
Wielu użytkowników LaTeX-a jest zadowolonych ze swoich pięknie składanych dokumentów LaTeX, ale nie mogą się powstrzymać od odrobiny zazdrości wobec użytkowników Markdowna — bo, cóż, składnia LaTeX *może* bywa czasem dość rozwlekła. Tak, listy, patrzymy na *was*...
Dobra wiadomość jest taka, że fantastyczny nowy [`markdown` pakiet LaTeX](https://ctan.org/pkg/markdown) pozwala pisać składnię markdown w dokumentach LaTeX (czyli prostsze wejścia), a mimo to nadal uzyskiwać pięknie złożone pliki PDF! Wystarczy wczytać `markdown` pakiet w swoim dokumencie i ująć materiał Markdown w `markdown` środowiska:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Lista zakupów
*Pamiętaj*, aby podczas nadchodzących [promocji](http://acme-marg.com) zgarnąć tyle, ile tylko się da!
## Jedzenie
- pieczona fasolka
- spaghetti
## Artykuły papiernicze
- notes
- ołówki
\end{markdown}
\end{document}
```
Albo jeśli wolisz umieścić materiał Markdown w `*.md` pliku:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Super! To najpewniej bardzo ucieszy osoby techniczne, ponieważ teraz mogą po prostu skopiować swoją `.md` dokumentację!
### Czy nadal mogę używać poleceń LaTeX, jeśli piszę w Markdown?
Tak, nadal możesz używać poleceń LaTeX w swoim materiale Markdown! Wystarczy przekazać `hybrid` na `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- notes (ten z dużym $E=mc^2$ na okładce)
```
### Jak mogę używać dosłownych znaków, takich jak '#' i '\_' (podkreślenia)?
#### Wpisywanie '#'
Nie możesz wpisać znaku '#' *wewnątrz `markdown` środowiska*. Nawet `\#` nie zadziała. Musisz zdefiniować polecenie takie jak `\newcommand{\texthash}{\#}`, a następnie użyć `\texthash` w swojej `markdown` środowiska. Podobnie z podkreśleniami, zwłaszcza gdy jest ich więcej niż jedno w tej samej linii, np. `$y = m_1 + n_2$`. Czasami łatwiej jest zakończyć bieżące `markdown` środowisko i zapisać problematyczne linie w zwykłym trybie LaTeX, a następnie rozpocząć kolejne `markdown` środowiska.
#### Wpisywanie '\_' (podkreślenia) i '\`' (backticka)
**Aktualizacja** (dodano 13 maja 2017): Od `markdown` wersji 2.5 można ustawić `underscores = false` i `codeSpans = false` aby wyłączyć podkreślenia i backticki. Umożliwia to pisanie indeksów dolnych w matematyce i cudzysłowów w trybie hybrydowym bez konieczności ucieczki znaków. Mamy gwiazdki do wyróżnień, więc jedyną naprawdę utraconą rzeczą są przykłady kodu w linii. Dzięki, Vít, za wskazówkę!
#### Środowiska, których należy unikać...
I chociaż możesz używać backticków do pisania dosłownego tekstu w linii albo wciąć linię o cztery spacje dla bloku dosłownego, nie używaj `lstlisting` ani `minted` środowisk LaTeX wewnątrz `markdown` środowisk. Po prostu nie.
#### Używanie HTML w środowisku markdown
I nie, nie możesz używać HTML wewnątrz środowiska LaTeX `markdown` (choć w zwykłym Markdown to częsta praktyka). Przepraszam.
**Aktualizacja** (dodano 13 maja 2017): Od `markdown` wersji v2.3 istnieje `html` opcja, która nie wyświetli tagów HTML dosłownie, jeśli są obecne w twoim materiale markdown, choć nie sformatuje też faktycznie zawartości tagów — tzn. `Cześć!` wyświetli po prostu Cześć! w zwykłej grubości. Ale encje HTML, takie jak `©` będą renderowane jako ©. Dzięki Vítowi za zwrócenie na to uwagi.
### Proponowane opcje pakietu markdown
Jednym zestawem `markdown` opcji pakietu, które mogą okazać się przydatne, jest:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Te opcje umożliwiają użycie
* składni markdown dla przypisów (takiej jak `[^1]`);
* list definicyjnych oraz `#` dla list numerowanych;
* „właściwych” wielokropków (…).
Oto [kompletny przykład](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) w galerii Overleaf, a oto [kolejny](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Hiperłącza i przypisy: jak?
W przykładzie Overleaf hiperłącze jest przypisem. Jak sprawić, by było hiperłączem hyperref?
`markdown` jest konfigurowalny, więc możesz zdefiniować, jak chcesz, aby różne elementy były renderowane. Dodanie tego do preambuły zrobi dokładnie to:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Aktualizacja** (dodano 13 maja 2017): `rendererPrototypes` było używane w wersji początkowej. Zwykłym użytkownikom zaleca się używanie `renderers` dla własnych definicji, ponieważ `rendererPrototypes` służy twórcom pakietów do dostarczania domyślnych ustawień. Jeśli zmodyfikujesz `rendererPrototypes`, narażasz się na ryzyko, że inny pakiet nadpisze twoje ustawienia. Dzięki Vítowi za zwrócenie na to uwagi!
### Dodawanie obrazów (zaktualizowano 8 listopada 2022)
* **Uwaga**: Następny przykład używa pliku graficznego (`example-image.pdf`) dostarczanego przez pakiet `mwe` Pakiet. Te pliki graficzne są dystrybuowane przez TeX Live, a więc przechowywane na serwerach Overleaf, dzięki czemu są dostępne jako zastępniki obrazów, takie jak poniżej.
Obrazy można włączać do markdownu, zapisując znacznik w następującym formacie:
```latex
```
Miejmy nadzieję, że nazwy parametrów `tekst alternatywny`, `nazwa pliku` i `"podpis obrazu"` opisują, do czego służą. Oto przykład ilustrujący ich działanie:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Pakiet mwe udostępnia obrazy przykładowe. Jego załadowanie jest
% nie jest konieczne, ponieważ te obrazy znajdują się w ścieżce wyszukiwania LaTeX-a.
% Tutaj ładujemy go dla przejrzystości tego przykładu.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Ten przykład pokazuje, jak zaimportować plik graficzny. Tutaj używamy
obrazu przykładowego udostępnionego przez pakiet `mwe`.
% Użyj \setkeys{Gin}, jeśli musisz zmienić rozmiar wyświetlania obrazu
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Ten przykład generuje następujący wynik:
#### Uwaga dotycząca szerokości obrazu
Podobnie jak większość pakietów, `markdown` ładuje inne pakiety, w tym [`keyval`](https://ctan.org/pkg/keyval?lang=en) i [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), aby korzystać z dostarczanych przez nie poleceń i funkcji. Tutaj szerokość obrazu jest ustawiana za pomocą polecenia `\setkeys` , które jest udostępniane przez `keyvals`. `Gin` jest „rodziną” klawiszy zdefiniowaną przez `graphicx` pakiet.
* **Uwaga**: Ponieważ używane jest polecenie LaTeX, tutaj `\setkeys`, *w obrębie* stronie `markdown` środowiska, wymagana jest `hybrid` opcja pakietu markdown.
#### Zmiana identyfikatorów umieszczania obiektów pływających (bardziej zaawansowane)
Składnia markdown do wstawiania ilustracji nie pozwala bezpośrednio określić identyfikatorów umieszczania obiektów pływających, ale możesz je dostosować, redefiniując sposób renderowania ilustracji:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Więcej informacji znajdziesz w [dokumentacji markdown](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Czy można tworzyć tabele za pomocą markdown w LaTeX? 😀
Niestety nie. Tabele są obecnie obsługiwane tylko w [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) , a pakiet LaTeX `markdown` nie ma obecnie dla tego obsługi.
**Aktualizacja** (dodano 13 maja 2017): Na podstawie wskazówki od Víta możliwe jest użycie `contentBlocks` rozszerzenia składni od wersji 2.4 albo dostosowanie `inputFencedCode` renderera, aby szybko zamienić tekst w stylu CSV na tabelę.
### Jeszcze więcej dobrodziejstw pakietu markdown...?
Jak wspomniano wcześniej, to fajny sposób na robienie notatek, a w połączeniu z kilkoma dobrymi klasami dokumentów LaTeX lub ustawieniami pakietów pozwala mieć piękny notatnik jeszcze w trakcie samego wykładu. Na przykład można go użyć z [klasami Tufte](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
A prosta i zwięzła składnia, która znacznie ułatwia pisanie list, oznacza, że teraz mamy *naprawdę szybki* sposób pisania [prezentacji Beamera](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) i [plakatów](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Baw się dobrze!
---
# 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/30-how-to-write-in-markdown-on-overleaf.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.