kpi.links

Документація

Формат сторінки

Markdown, таблиці, відео — на прикладах.

Сторінки пишуться звичайним Markdown (GitHub Flavored). Ніякого frontmatter: назва й тека задаються полями над редактором.

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

Приклад

## Реквізити

Оплата до **10 числа** кожного місяця.

| Гуртожиток | Вартість за місяць |
| --- | --- |
| № 7 | 1 200 ₴ |
| № 12 | 1 450 ₴ |

Квитанцію надсилати старості до кінця дня.

> Хто платить після 15-го — доплачує пеню.

Розділи

# — розділ сторінки. Кожен потрапляє в бічне меню, отримує якір і підсвічується, коли доходиш до нього прокруткою:

# Вища математика
## Оцінювання
### Якщо пропустили строк

Назва самої сторінки — це поле «Назва» над редактором, окремо її писати не треба. У меню видно три рівні; #### і глибші лишаються тільки в тексті.

Посилання на розділ можна скопіювати з адресного рядка після кліку в меню:

/groups/ГА-61/info/zagalna-informacija#ocinjuvannja

Факти

Рядок, який починається з жирного підпису й двокрапки, стає рядком фактів — тим, за чим студент і приходить:

**Викладач:** Іваненко Іван Іванович
**Пари:** пн 10:25 (лекція), чт 12:20 (практика)
**Ауд.:** 401-18

Рядки, що стоять поспіль, збираються в один блок. Досить одного рядка без жирного підпису — і весь абзац лишається звичайним текстом.

Дедлайн, який сам рахує дні

Факт із підписом «Дедлайн», «Термін», «Строк» чи «Здати до» сайт читає як дату й дописує поруч, скільки лишилось:

**Дедлайн:** 10 жовтня
**Здати до:** 7.09.2026

Поруч із датою стає плашка з відліком: «за 5 днів», «завтра», «сьогодні». За три дні до строку вона червоніє, після строку показує «минув» — і так три місяці, далі зникає, бо рахувати вже нема чого. Рік можна не писати: береться найближчий. Формати: 10 жовтня, 10.10, 10.10.2026, 2026-10-10.

Відлік рахує браузер того, хто читає, тому він завжди свіжий — навіть якщо сторінку ніхто не відкривав з вересня.

Списки, код, цитати

- звичайний список
  - вкладений
1. нумерований

`інлайновий код`, **жирний**, *курсив*, ~~закреслене~~

> цитата

Список зі значками — те, що лишилось зробити:

- [ ] здати звіт
- [x] отримати допуск

Значки показують стан, але не натискаються: щоб відмітити зроблене, відкрийте редактор і замініть [ ] на [x]. Так у групі видно, хто саме це зробив, — правка лягає в історію сторінки.

Блоки коду з підсвіткою:

```bash
ssh student@server
```

Підсвітка вмикається тільки тоді, коли після трьох лапок названо мову.

Помітки

Цитата, яка починається з позначки, стає помітною плашкою:

> [!ВАЖЛИВО]
> Без допуску до сесії не пустять.

Важливо

Без допуску до сесії не пустять.

Позначок п'ять: [!ПРИМІТКА], [!ПОРАДА], [!ВАЖЛИВО], [!УВАГА], [!ОБЕРЕЖНО]. Англійські з GitHub ([!NOTE], [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION]) працюють так само. Підпис можна замінити своїм — допишіть його в тому ж рядку:

> [!УВАГА] Заяву несуть особисто
> Сканом не приймають.

Позначка, якої немає в списку, нічого не робить — цитата лишається цитатою.

Посилання

У реченні посилання лишається посиланням:

Здавати через [форму](https://forms.gle/) до суботи.

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

[Classroom](https://classroom.google.com/) · [Матеріали](https://example.com/)

Роздільники: · | , ; —. Це не окремий синтаксис — на GitHub такий документ виглядає як завжди.

Посилання на зустрічі краще класти не сюди, а на вкладку Посилання — тоді вони з'являться на самих парах у розкладі.

Посилання на сусідню сторінку

Подвійні дужки з назвою — і сайт сам знайде сторінку в вікі групи:

Гроші за кімнату — у [[Гуртожиток]].
Про це вже написано в [[Оплата|окремій сторінці]].

Адресу писати не треба, і перейменування сторінки посилання не ламає. Якщо такої сторінки ще немає, посилання стає червоним пунктиром — клік по ньому відкриває редактор із уже вписаною назвою. Так вікі й розростається: пишете, як думаєте, а прогалини заповнюєте потім.

Таблиці

Стовпці можна вирівняти двокрапками в рядку з рисками:

| Предмет | Тиждень | Бал |
| :--- | :---: | ---: |
| Матан | 1 | 20 |

Широка таблиця не розтягує сторінку — вона прокручується всередині себе.

Відео

Досить кинути посилання на YouTube окремим рядком — воно саме стане плеєром:

https://youtu.be/aqz-KE-bpKQ

Таймкод із посилання зберігається, тому «дивись з 1:30» працює:

https://youtu.be/aqz-KE-bpKQ?t=1m30s
https://www.youtube.com/watch?v=aqz-KE-bpKQ&t=90

Можна й тегом — тоді title стане підписом плеєра:

<iframe src="https://www.youtube.com/watch?v=aqz-KE-bpKQ" title="Лекція"></iframe>

Посилання всередині речення відео не стає. Iframe на будь-який інший домен видаляється.

Файли

Перетягніть файл у поле редактора, вставте його з буфера (Ctrl+V) або натисніть «Файл» на панелі — завантаження почнеться одразу, а на місці курсора з'явиться заготовка. Поки файл їде, сторінку можна писати далі: коли доїде, заготовка сама стане посиланням.

До 4 ГБ на файл. Байти йдуть із браузера просто у сховище, тому розмір ні на що на сайті не впливає — а от чужий мобільний інтернет впливає, тому здоровий глузд лишається за вами.

У тексті вкладення виглядає як звичайне посилання:

[Методичка до лабораторних.pdf](/files/6nJk2QxAtM1p)
![Схема установки.png](/files/Rr7dLm0WqZ4v)

Що з цього виходить на сторінці:

  • Фото — картинка на місці, як завжди в Markdown (окличний знак попереду).
  • PDF — картка, яка розгортається в перегляд просто на сторінці; поки її не розгорнули, файл нікуди не їде.
  • Відео й аудіо — програвач із перемоткою.
  • Решта (docx, zip, xlsx) — рядок зі значком типу, назвою й розміром, який завантажує файл.

Перегляд робиться тільки з посилання, яке стоїть окремим абзацом. Усередині речення файл лишається звичайним посиланням — так і задумано, щоб не рвати фразу.

Підпис у квадратних дужках можна змінити на будь-який — це те, що побачать у картці:

[Торішні білети, якщо треба готуватись](/files/6nJk2QxAtM1p)

Вкладення закриті так само, як сама вікі: посилання на файл відкриється лише в того, хто в групі. Видалити файл із самої сторінки не можна — приберіть посилання, і воно зникне з тексту; сам файл лишається у сховищі, бо на нього може посилатись стара версія сторінки.

Дрібниці наостанок

Довге сховати під згортку:

<details><summary>Усі 40 питань до екзамену</summary>

1. Перше питання

</details>

Клавіші — <kbd>Ctrl</kbd>, виноска — [^1] у тексті й [^1]: пояснення внизу; вона сама переїде в кінець сторінки. Картинку можна вставити й посиланням на чужу адресу — ![підпис](https://…), — але покладатись на неї не варто: зникне там, зникне й тут. Своє вкладення надійніше.

Своїм HTML оформити сторінку не вийде: style, class і target зрізаються, <script> видаляється. Це навмисно — вікі пише вся група, і одна людина не має можливості зламати іншим верстку чи підсунути чужий скрипт.