Пишіть у Markdown

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

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

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

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 у режимі «Код». Їхні кнопки сховані у візуальному режимі. Користуйтеся режимом «Код», коли працюєте з метаданими, синтаксисом цитувань чи іншими конструкціями джерела.

Завантажте джерело прикладу

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

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

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

Перемикайтеся між Код, Візуально та Обидва. У кожному режимі документ лишається джерелом 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, і застосуйте його.

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

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

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

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

Відкриває редактор діаграм у режимі Mermaid. Малюйте блок-схему на полотні або редагуйте код Mermaid, а потім виберіть Вставити як Mermaid, щоб додати її в позицію курсора як блок коду mermaid в огорожі. Див. Діаграми Mermaid.

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

Показує заголовки, рисунки, таблиці, формули, мітки, цитування та завдання документа в порядку джерела, кожен із посиланням на його рядок. Він також читає назву, авторів, ключові слова, дату та анотацію з метаданих і може скопіювати їх для форми подання. Див. Відомості про документ.

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

Змінює клас документа, розмір сторінки, колонки, поля, основний шрифт, розмір шрифту, мову, міжрядковий інтервал і нумерацію розділів. Oleafly записує ваш вибір у метадані YAML, які читає Pandoc, і додає блок метаданих, якщо файла їх не має. Див. Налаштування документа.

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

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

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

Знайти

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

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

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

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

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

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

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

Діаграми Mermaid

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

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

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

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

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

Пошук і впорядкування джерел →

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

Щоб лишити наявну чернетку в Markdown, створіть порожній документ Markdown, вставте чернетку в main.md та імпортуйте її зображення і бібліографію. Окремий імпорт Документ Markdown у бібліотеці зараз перетворює чернетку на LaTeX. Занесення наявної роботи пояснює обидва шляхи.

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