> 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/uk/dokladni-statti/32-markdown-into-latex-with-style.md). # Markdown у LaTeX зі стилем **Оновлення після публікації** (13 травня 2017): Ми вдячні Віту Новотному, автору/підтримувачу `markdown` пакета, за те, що він написав нам із корисними зауваженнями щодо оригінальної статті. Ми раді опублікувати цю оновлену версію, яка враховує та містить його поради й пропозиції. ### Вступ Деякий час тому ми раділи виходу [`пакета markdown`](http://www.ctan.org/pkg/markdown) який зробив можливим написання синтаксису markdown у документах LaTeX — і відсвяткували це статтею під назвою [Як писати в Markdown в Overleaf](/latex/uk/dokladni-statti/30-how-to-write-in-markdown-on-overleaf.md) метою якої було продемонструвати деякі з підтримуваних елементів синтаксису. **Пам’ятайте**: Вам потрібно буде компілювати ваші `.tex` файли з `--shell-escape` параметром, щоб це працювало в локальних інсталяціях LaTeX — Overleaf робить це для вас (автоматично). Майте на увазі, що більшість порталів для подання статей не вмикають `--shell-escape`— якщо вам дозволено завантажувати лише вихідний PDF вашого рукопису, ваші файли LaTeX, що містять markdown, можуть не зібратися успішно під час обробки системою подання видавця. Одна з ідей, на яку натякала [попередня стаття](/latex/uk/dokladni-statti/30-how-to-write-in-markdown-on-overleaf.md) полягає в тому, що поєднання markdown і LaTeX дає чудове розділення змісту та стилю. Автори (особливо ті, хто вже знайомий із markdown) мали б набагато лаконічніший синтаксис для роботи (з певними застереженнями), і водночас зберігали б доступ до всіх переваг пакетів і шаблонів LaTeX для оформлення та форматування. Той [попередня стаття](/latex/uk/dokladni-statti/30-how-to-write-in-markdown-on-overleaf.md) наводив кілька прикладів використання markdown у [презентаціях Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) та [постерах](https://www.overleaf.com/read/jtbgmmgqrqmh): сьогодні ми розглянемо ще цікавіші та захопливіші можливості оформлення! ### Використання markdown у стилізованих шаблонах LaTeX Окрім наведених вище прикладів, ви можете використовувати markdown майже в усіх шаблонах. Ось кілька коротких прикладів: * Функція [помаранчева книга Lagrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) шаблон * Функція [роздатковий матеріал у стилі Туфте](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) шаблон * Цей [дуже гарний шаблон статті](https://www.overleaf.com/read/xfsrpsmdtqvt) авторства Thiago Ви можете помітити, що два з них — шаблони статей, а один — шаблон книги. [`пакета markdown`](http://www.ctan.org/pkg/markdown) визначає, чи `\chapter` команда доступна для використання в конкретному документі LaTeX і зробить заголовок першого рівня `markdown` рядка відображатися як `\chapter` або `\section` відповідно. ### Дуже швидкі роздаткові матеріали: markdown + pocketmod Відтоді, як я вперше дізнався про markdown, він здався мені швидким і зручним способом робити нотатки: це нагадує те, як я міг би поспіхом занотовувати їх на клаптиках паперу чи стікерах — особливо завдяки синтаксису маркованих і нумерованих списків. Коли я вперше створив [шаблон PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) у 2015 році, я дуже хотів мати спосіб писати markdown у LaTeX, щоб я міг створювати PocketMod'и *з* markdown, бо це здавалося… доречним. Записувати нотатки простим синтаксисом у маленьких складених буклетах, але з гарною типографікою — дехто називає PocketMod'и «зінами», бо це маленькі 8-сторінкові буклети, які можна зробити з одного аркуша паперу A4. І справді, це виявилося можливим! Це значно полегшує швидке створення [мінібуклету щотижневого планера](https://www.overleaf.com/read/zfzcxygqwqsq) або маленької [книжки-розповіді з малюнками](https://www.overleaf.com/read/rppnsfgnrhsf). Так, мою доньку розважало бачити книжку-розповідь, зроблену з її власних малюнків… щоправда, лише на 10 хвилин! [`пакета markdown`](http://www.ctan.org/pkg/markdown) дозволяє вам налаштовувати, як кожен елемент синтаксису markdown відтворюється у LaTeX, тому я перевизначив стандартний `![](img_file "caption")` синтаксис так, щоб підпис розміщувався під файлом зображення (без префікса «Figure» чи нумерації), а потім вставив розрив сторінки. Це ще більше спрощує створення книжки з малюнками. Ось відео, яке показує, як скласти буклет: {% embed url="" %} ### Прості буклети з рецептами Якщо подумати, рецепт складається зі списків: списку інгредієнтів, списку інструкцій з підготовки або приготування, а можливо, й списку приміток (час приготування, порції тощо). Тож замість того, щоб писати таке: ```latex \begin{enumerate} \item Спочатку зробіть це \item Потім зробіть те ... \end{enumerate} ``` Мені, безумовно, хотілося б мати змогу писати так: ``` #. Спочатку зробіть це #. Потім зробіть те ``` І так само для інгредієнтів: ``` - 2 яйця - дрібка солі ``` Отже, щоб легко створити швидкий рецепт, ми можемо написати таке: ``` # Яєчня-бовтанка Час приготування : 5 хвилин Порцій : 1 ## Інгредієнти - 4 яйця - 1 ч. л. масла - 1/4 склянки молока - сіль, перець (за смаком) ## Інструкції #. Збийте яйця, молоко... #. Розігрійте масло на пательні... #. ... ``` Гм, це виглядає багатообіцяюче. Декілька з нас в Overleaf (і наші родини) поділилися улюбленими швидкими рецептами (ідеальними для тих, хто вперше готує), і я швиденько змайстрував (вибачте за каламбур) [шаблон швидкого рецепта](https://www.overleaf.com/read/gscqdhnwzsfg) який ви можете писати за допомогою markdown *та* і перетворювати на мінібуклет. [![A recipe booklet produced on Overleaf using markdown](/files/dd404b14d5c6e54fb7ac1cf5c2f575428462bde8)](https://www.overleaf.com/read/gscqdhnwzsfg) А тепер ще трохи веселощів. Під капотом це все ще LaTeX, тож ми можемо й далі оформлювати різні елементи — заголовки розділів, марковані списки, шрифти тощо — використовуючи звичні трюки LaTeX. Саме тоді я дещо захопився і вигадав *три* «теми» для `simple-recipe` класу! ### Бонус 1: Деякі застереження під час використання пакета markdown * SyncTeX не зовсім працюватиме. В Overleaf це означає, що операції «position in preview» і «click-in-preview-to-jump-to-source» не працюватимуть у `markdown` областях. * `\\` втрачає своє звичайне значення: звичний «два пробіли, а потім новий рядок» `markdown` трюк тут не працює, бо кінцеві пробіли будуть видалені парсером Lua, як це задокументовано в [`markdown` документація пакета](http://texdoc.net/pkg/markdown). `\newline` хоча спрацює. * Обережно з кількома символами підкреслення в одному рядку — це може бути проблемою, якщо: * ви працюєте з багатьма індексами у своїх рівняннях (порада: виходьте з `markdown` середовища в таких випадках); * ви любите використовувати підкреслення у своїх BibTeX-ключах. Ви можете встановити `underscores=false` з останніми `пакета markdown` файлами, щоб підкреслення для індексів працювали, але це все одно не спрацює з підкресленнями у BibTeX-ключах. **Оновлення** (13 травня 2017): Підкреслення в BibTeX-ключах працюватимуть з `markdown` версії v2.5.2 і далі — дякуємо, Віте! * У вас виникнуть певні труднощі з відображенням буквального символу решітки, тому що навіть `\#` не спрацює! Зазвичай я визначаю нову команду й використовую її замість цього. ### Бонус 2: Нові можливості в оновленому пакеті markdown `markdown` версія v2.4 і пізніші додали підтримку для деяких справді гарних елементів синтаксису: * **Синтаксис вбудованих виносок**: `...^[це виноска]` (потрібно `inlineFootnotes` параметр) * **Цитати:**`[@smith1990]` (потрібно `цитування` параметр; також остерігайтеся підкреслень у ваших BibTeX-ключах!) * **Блоки коду**: Ви можете використовувати або тильди `~` або зворотні апострофи `` ` `` як обмежувачі. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Якщо ви хочете використовувати ці нові можливості, обов’язково завантажте оновлені версії `markdown.lua`, `markdown.tex` та `markdown.sty` до вашого проєкту — або ви можете просто створити новий проєкт на основі [цього шаблону](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/uk/dokladni-statti/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.