# Пишіть у Markdown

Черніть у звичному Markdown і створюйте PDF або документ, який співавтори зможуть редагувати.

Markdown добре пасує для наукових нотаток, звітів і ранніх чернеток. Oleafly дає йому окрему панель форматування та збірку через Pandoc, а файли джерела можна використовувати поза застосунком.

## Створіть звіт

1. Виберіть **Новий проєкт → Використати шаблон → Порожній документ Markdown**.
2. Назвіть проєкт **Польові нотатки** і відкрийте `main.md`.
3. Вставте цей приклад, потім виберіть **Скомпілювати знову** або натисніть **⌘Enter / Ctrl+Enter**.
4. Якщо Oleafly запропонує налаштувати потрібний рушій, завершіть налаштування та скомпілюйте ще раз.

```markdown title="main.md"
---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.
```

PDF має містити назву, заголовки, нумерований список і таблицю. Метадані між першою парою рядків `---` задають назву документа й автора.

## Редагування джерела та візуальне

Перемикач на початку панелі інструментів має три режими. **Код** редагує Markdown безпосередньо. **Візуально** дає відформоване редагування заголовків, абзаців, списків, посилань, зображень і таблиць. **Обидва** показує джерело та відформатований текст разом. Відкрийте його меню, щоб вибрати **Один над одним** або **Розділити**. Нові проєкти відкриваються в режимі «Код», і кожен проєкт запам’ятовує режим, у якому ви його лишили.

Підкреслення, виділення кольором, верхній і нижній індекс — це елементи керування форматуванням Pandoc у режимі «Код». Їхні кнопки сховані у візуальному режимі. Користуйтеся режимом «Код», коли працюєте з метаданими, синтаксисом цитувань чи іншими конструкціями джерела.

[Завантажте джерело прикладу](/examples/writing-example.md)

## Кожен інструмент панелі

Виділіть текст, перш ніж клацати елемент керування форматуванням. У режимі «Код» більшість інструментів обгортає виділене або вставляє заповнювач. Відкрийте **Більше параметрів форматування** (`…`), щоб дістатися елементів, які не вмістилися в панель.

### Код / Візуально

Перемикайтеся між **Код**, **Візуально** та **Обидва**. У кожному режимі документ лишається джерелом Markdown.

### Скасувати дію

Скасовує останню правку. ⌘Z / Ctrl+Z.

### Повторити дію

Повертає скасовану правку. **⌘Shift+Z / Ctrl+Shift+Z**.

### Заголовок → Заголовок

Виберіть **Заголовок** у меню заголовка, щоб вставити `# Title`. Замініть текст заголовка власною назвою.

### Заголовок → Розділ

Виберіть **Розділ** у меню заголовка, щоб вставити `## Section`. Замініть текст заголовка власною назвою.

### Заголовок → Підрозділ

Виберіть **Підрозділ** у меню заголовка, щоб вставити `### Subsection`. Замініть текст заголовка власною назвою.

### Заголовок → Підпідрозділ

Виберіть **Підпідрозділ** у меню заголовка, щоб вставити `#### Subsubsection`. Замініть текст заголовка власною назвою.

### Заголовок → Дрібний заголовок

Виберіть **Дрібний заголовок** у меню заголовка, щоб вставити `##### Minor heading`. Замініть текст заголовка власною назвою.

### Заголовок → Заголовок параграфа

Виберіть **Заголовок параграфа** у меню заголовка, щоб вставити `###### Paragraph heading`. Замініть текст заголовка власною назвою.

### Маркований список

Починає невпорядкований список. `- Item`.

### Нумерований список

Починає послідовність. `1. Item`.

### Список завдань

У режимі «Код» додайте завдання й змініть `[ ]` на `[x]`, коли його виконано. `- [ ] Task`.

### Цитата блоком

Поставте цитату окремим рядком. `> quoted text`.

### Жирний

Підсилює виділений текст. `**text**`; ⌘B / Ctrl+B.

### Курсив

Виділяє термін. `*text*`; ⌘I / Ctrl+I.

### Закреслений

Позначає текст як застарілий. `~~text~~`.

### Код у рядку

Форматує назву файла, команду або ідентифікатор. Текст у зворотних лапках.

### Підкреслений

Виділіть фразу в режимі «Код». `[text]{.underline}`.

### Виділення кольором

Виділіть фразу в режимі «Код». `[text]{.mark}`.

### Верхній індекс

Виділіть степінь у режимі «Код». `^text^`.

### Нижній індекс

Виділіть нижній індекс у режимі «Код». `~text~`.

Підкреслення та виділення кольором використовують атрибути Pandoc, тож форматування потрапляє в PDF. Користуйтеся цими елементами керування замість додавання сирих теґів HTML у рукопис.

### Вставити посилання

У режимі **Код**: вставляє `[link text](url)`. Замініть обидва заповнювачі.

У режимі **Візуально**: відкриває **URL посилання**. Введіть адресу та застосуйте її до виділеного. Скористайтеся **Вилучити посилання**, щоб лишити текст без посилання.

### Вставити зображення

У режимі **Код**: вставляє `![caption](image-filename)`. Замініть шлях і підпис.

У режимі **Візуально**: відкриває **Файл зображення**. Введіть шлях у проєкті, наприклад `figures/plot.png`, і застосуйте його.

### Вставити таблицю

У режимі **Код**: вставляє три стовпці, заголовок і два рядки даних. Замініть назви стовпців і комірки.

У режимі **Візуально**: вставляє таблицю, яку можна редагувати, з такими самими початковими розмірами.

### Намалювати діаграму

Відкриває [редактор діаграм](/docs/figures-diagrams/) у режимі Mermaid. Малюйте блок-схему на полотні або редагуйте код Mermaid, а потім виберіть **Вставити як Mermaid**, щоб додати її в позицію курсора як блок коду `mermaid` в огорожі. Див. [Діаграми Mermaid](#mermaid-diagrams).

### Відомості про документ

Показує заголовки, рисунки, таблиці, формули, мітки, цитування та завдання документа в порядку джерела, кожен із посиланням на його рядок. Він також читає назву, авторів, ключові слова, дату та анотацію з метаданих і може скопіювати їх для форми подання. Див. [Відомості про документ](/docs/document-insights/).

### Налаштування документа

Змінює клас документа, розмір сторінки, колонки, поля, основний шрифт, розмір шрифту, мову, міжрядковий інтервал і нумерацію розділів. Oleafly записує ваш вибір у метадані YAML, які читає Pandoc, і додає блок метаданих, якщо файла їх не має. Див. [Налаштування документа](/docs/document-settings/#markdown).

### Відомості про проєкт

У режимі **Код**: показує статистику проєкту та відомості про виділене.

У режимі **Візуально**: показує статистику поверхні візуального редагування.

### Знайти

У режимі **Код**: відкриває пошук у активному файлі з ⌘F / Ctrl+F.

У режимі **Візуально**: кнопка «Знайти» панелі джерела схована.

Імпортуйте зображення через дерево файлів, перш ніж на нього посилатися. Тримайте шляхи до зображень відносними до рукопису, щоб архів джерела працював на іншому комп’ютері.

## Формули та блоки коду

Математичний вираз у рядку пишіть як `$x^2$`. Винесену формулу поставте між двома парами знаків долара:

```markdown
$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$
```

Зразок коду візьміть у потрійні зворотні лапки та вкажіть його мову після початкової огорожі. Це конструкції джерела; у панелі Markdown немає окремої кнопки для формул чи блоків коду в огорожі.

## Діаграми Mermaid

Виберіть **Намалювати діаграму** на панелі інструментів, щоб створити блок-схему Mermaid у редакторі діаграм. **Вставити як Mermaid** додає її як блок коду в огорожі:

````markdown
```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```
````

У режимі **Обидва** відформатована сторона малює блок як діаграму. PDF потребує зображення, тож редактор також зберігає відрендерений PNG у `figures/mermaid-<hash>.png`, а компіляція ставить це зображення на місце блока. Тому діаграма з’являється й у скомпільованому PDF. Якщо ви потім відредагуєте блок вручну, PDF показуватиме код, доки ви знову не вставите або не збережете діаграму з редактора. Див. [Mermaid у документах Markdown](/docs/figures-diagrams/#mermaid-in-markdown-documents).

## Цитування та бібліографія

Імпортуйте або створіть `references.bib`, додайте `bibliography: references.bib` у метадані YAML і цитуйте наявний ключ через `[@citation-key]`. Pandoc використовує бібліографію, щоб створити відформатовані цитування та список літератури.

[Пошук і впорядкування джерел →](/docs/citations/)

## Імпорт і експорт

Щоб лишити наявну чернетку в Markdown, створіть порожній документ Markdown, вставте чернетку в `main.md` та імпортуйте її зображення і бібліографію. Окремий імпорт **Документ Markdown** у бібліотеці зараз перетворює чернетку на LaTeX. [Занесення наявної роботи](/docs/import-project/) пояснює обидва шляхи.

Скомпілюйте PDF або скористайтеся кнопкою **Експорт**, щоб створити Word, HTML, Typst, LaTeX чи звичайний текст. ZIP із джерелом підійде, щоб поділитися початковим Markdown та його ресурсами. [Експорт і перетворення](/docs/export/) описує послідовність дій і перевірки, які варто зробити в перетвореному файлі.