Системи знань: Notion, Evernote, Obsidian, Markdown

Сьогодні ти заводиш теку, у якій лежать усі твої рішення

Тема 5 · урок 1 з 2 · наскрізний проєкт STARTUP LAUNCH · 120 хвилин

У тебе вже є сервер, бриф, таблиця ринку, аналітика, бренд і пітч. За шість уроків ти ухвалив кілька десятків рішень. Серед них — чому саме ця аудиторія, звідки взялося число ринку, чому ціна така, а не інша. Частина цих рішень уже зникла — вони жили в чаті, у голові й у вкладках браузера.

Сьогодні ти заводиш базу знань продукту: місце, де живуть рішення, джерела й нотатки, які інакше губляться. Спочатку як робочу базу в Notion, потім — як теку простих текстових файлів ~/www/kb/. Вони відкриються й через десять років без жодної підписки.

Після уроку ти вмієш

• писати нотатку, у якій одна думка й одне джерело, а не файл «про все»;
• розмічати текст простими значками: заголовки, списки, посилання, код, цитати — це називають Markdown;
• додавати нотатці паспорт із дати, тегів і статусу — і знаходити в ньому помилку, через яку він не читається;
• називати файли так, щоб вони відкривалися за адресою на Linux-сервері;
• зібрати теку ~/www/kb/ з восьми нотаток і здати її на автоперевірку.

Слова Markdown, front-matter і YAML поки нічого не означають — розберемо кожне тоді, коли воно знадобиться.

Хід уроку

Навіщо продукту база знань

Три ситуації, у яких пам’ять не рятує

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

Новий учасник команди питає те саме двічі. Кожне «а чому ми не робимо Х?» коштує тобі десяти хвилин переказу того, що вже обговорювали. Записане рішення відповідає за тебе: посилання замість переказу.

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

Чому чат не працює як база знань

Одна нотатка — одна думка

Чому довгий документ «про все» не працює

Найчастіша перша спроба виглядає так: файл все-про-конкурентів.md на дванадцять екранів, де вперемішку ціни, функції, відгуки й твої здогади. Він здається зручним: усе в одному місці. Але з ним неможливо зробити нічого з того, заради чого база знань потрібна.

Такий файл не має одного тегу: він одночасно про ціни, про ринок і про ризики. Він не має одного статусу: половина перевірена, половина — здогад. На нього не можна послатися точно: посилання веде «у файл», а не в думку. І його ніхто не перечитує — зокрема ти сам.

Як зрозуміти, що нотатка неатомарна

• у заголовку є слово «все», «різне», «нотатки» або перелік через кому;
• ти не можеш дати їй один тег, не збрехавши;
• половина тексту перевірена, половина — здогад, а status один;
• щоб послатися на потрібне місце, доводиться писати «див. приблизно посередині».

Markdown: розмітка, яку читає й людина, і машина

Кілька службових символів замість панелі кнопок

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

Одинадцять значків, якими пишуть майже все

Значків у Markdown десятки, але в робочій нотатці ти щоразу користуєшся тими самими одинадцятьма. Вони в таблиці нижче.

Вивчати їх напам’ять не треба. Один раз напиши нотатку з таблицею перед очима — і наступного разу рука зробить сама.

Одне спільне правило варто помітити зараз: майже скрізь потрібен пробіл після значка. #Заголовок лишиться текстом, а # Заголовок стане заголовком.

Front-matter: паспорт нотатки

Кілька рядків YAML на початку файлу, які роблять теку базою даних

Перед самим текстом нотатки ставлять кілька службових рядків: дата, теги, статус. Зверху й знизу їх відділяє рядок із трьох дефісів — ---. Цей блок називають front-matter, тобто «те, що спереду».

Частиною Markdown він не є. Це домовленість інструментів: її ввели генератори сайтів, а підхопили редактори нотаток. Усередині рядки пишуть однаково — ключ: значення. Такий запис зветься YAML.

Навіщо він потрібен. Без цих кількох рядків тека kb/ — просто вісім текстів. З ними тека стає базою, з якою можна працювати.

Нотатки шикуються за датою — це поле date. Лишаються тільки потрібні за темою — це tags. Ховаються ті, що ще не перевірені — це status: verified. А з усього разом збирається сторінка kb/index.html. Саме це ти робитимеш на уроці 8.

П’ять помилок у front-matter

Помилки тут бувають двох різних видів, і плутати їх не варто.

Перший вид — файл узагалі не читається. Таких випадків два: title:Чому ціна без пробілу після двокрапки й порожній рядок перед першим ---. Програма спиняється й прямо каже, що не змогла.

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

Так, tags: ринок дає один рядок замість списку тегів. date: 24.09.2026 дає рядок, який не сортується за датою. А status: no перетворюється на «ні» замість слова «no».

Червоне ти побачиш в обох випадках. Але в другому доведеться самому шукати, де саме розійшлися задум і результат.

Живий редактор: пиши ліворуч, дивись праворуч

Той самий текст, що поїде в ~/www/kb/

Ліва панель — те, що фізично лежить у файлі. Права — те, у що це перетворюється. Панель нижче окремо розбирає front-matter і показує, яких обов’язкових полів бракує. Переписуй приклад під свій продукт: це чернетка першої з восьми нотаток.

Розбір Markdown тут спрощений — рівно той набір, що потрібен нотатці: заголовки, жирний, курсив, списки, посилання, код, цитати, таблиці й лінії. Складніші випадки (вкладені списки, зображення, HTML усередині Markdown) редактор навмисно не показує.

Чому текстовий формат переживає сервіси

Файл, який відкриється й через десять років

.md — це звичайний текст. Його відкриє Блокнот, будь-який редактор коду, термінал на сервері, телефон і програма, якої ще не написали. Для цього не потрібні ані підписка, ані інтернет, ані те, щоб компанія-автор формату досі існувала.

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

Два рядки цієї таблиці варті окремого слова.

Історія змін у теки .md сама не з’являється. Переписав файл — попередній варіант зник назавжди. Хочеш історію — або тримай копії з датою в імені, або постав git.

А спільне редагування — те місце, де хмара виграє начисто. Двом людям правити один .md одночасно незручно, і жоден трюк цього не виправить.

Notion, Evernote, Obsidian: не «що краще», а «що для чого»

П’ять критеріїв, за якими це взагалі можна порівнювати

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

Evernote працює радше як склад. Ти складаєш туди все, що зустрів: нотатники, теги, а розширення браузера зберігає чужу сторінку цілком. Це зручно, коли головне — нічого не загубити. Зв’язувати між собою власні думки в ньому виходить гірше.

Obsidian — це редактор, який відкриває твою власну теку з файлами .md на диску. Акаунт не потрібен, інтернет теж. Нотатки чіпляються одна до одної звичайними посиланнями всередині тексту. Синхронізацію між пристроями й публікацію продають окремо. Але тека з файлами лишається твоєю в будь-якому разі.

Як обирати під задачу

Ім’я файлу — це частина адреси

Чому пробіли й кирилиця створять проблеми саме на сервері

Локально ім’я Аналіз ринку.md виглядає нормально. Але на уроці 8 ця нотатка стане сторінкою за адресою http://91.219.61.4/s/<логін>/kb/…, а в URL немає ані пробілів, ані кирилиці: браузер кодує кожен «незручний» байт трьома символами.

Правило іменування на весь модуль

• тільки малі латинські літери, цифри й дефіс: kebab-case;
• ім’я — це тема нотатки, а не її номер: competitor-b-pricing.md, а не note3.md;
• жодних пробілів, підкреслень «бо так вийшло», крапок усередині назви;
• дата — у front-matter, а не в імені, якщо тільки нотатка не про подію;
• експорт із Notion лишає хеш на кінці — Конкуренти 3f2a9c1b….md: хеш прибираєш повністю.

Конструктор: вісім нотаток твого продукту

Сторінка стежить за повнотою front-matter і показує, які теми ще не покриті

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

Практика: від бази в Notion до теки kb/

Виконуй по черзі. Галочки зберігаються — сторінку можна закрити.

$p = "$HOME\kb\pricing-decision.md"
$t = Get-Content .\draft.md -Raw
[IO.File]::WriteAllText($p, $t, (New-Object Text.UTF8Encoding $false))

# працює тільки з латиницею; кириличні імена перейменовуй за підказкою редактора
for f in *.md; do mv "$f" "$(echo "$f" | tr ' A-Z' '-a-z')"; done

Автоперевірка check11 5, перша частина

Система прочитає твою теку ~/www/kb/, спробує розібрати front-matter кожного файлу як YAML і подивиться на імена. Спроби не обмежені.

Демонстраційний режим: результат згенеровано для показу. На сервері ця кнопка запускає check11 5 від імені учня і читає ~/.progress/11-5.json.

Що вчитель дивиться на екрані

• сама база в Notion: є всі три вигляди — таблиця, дошка, фільтр «тільки перевірене», і фільтр справді щось відсіює;
• записи мають заповнені властивості, а не порожні поля;
• у кожного запису є джерело: посилання, назва документа або «інтерв’ю з …, дата»;
• ти відкриваєш будь-яку нотатку з kb/ і пояснюєш, яке рішення продукту вона підпирає.

Шкала виконання

Це те, що бачить учитель, коли виставляє оцінку.

Домашнє завдання

1. Доведи кількість нотаток у ~/www/kb/ до десяти. Дві нові мають бути про те, чого сьогодні не було. Наприклад, відхилена ідея й термін, який ти сам плутав.
2. Перевір кожне ім’я файлу: жодного пробілу, жодної кириличної літери, жодного хеша з експорту.
3. Прожени свій front-matter через редактор на цій сторінці — усі п’ять полів мають бути зеленими.

Звідки взяті факти

Формати й специфікації перевіряються за первинними джерелами, умови сервісів — за їхніми офіційними сторінками. Перевіряти дозволено й корисно: тарифи змінюються, специфікації — рідко.

• Markdown, 2004, Джон Ґрубер: мета формату й базовий синтаксис — daringfireball.net · Markdown Syntax
• Спільний мінімум, який усі реалізації розуміють однаково — spec.commonmark.org · CommonMark
• Таблиці, чекбокси й закреслення — розширення GitHub, а не базовий Markdown — github.github.com/gfm · GitHub Flavored Markdown Spec
• YAML: синтаксис ключ: значення, списки, лапки — yaml.org · YAML 1.2.2 specification
• yes, no, on, off як логічні значення в YAML 1.1 — джерело «норвезької проблеми» — yaml.org · type/bool, pyyaml.org · документація PyYAML
• Front-matter як домовленість інструментів: блок YAML між --- на початку файлу — jekyllrb.com · Front Matter
• Obsidian зберігає нотатки як звичайні файли .md у теці на диску; властивості нотатки — той самий YAML front-matter — help.obsidian.md · Properties, obsidian.md
• Notion: експорт вмісту в Markdown & CSV, HTML і PDF — notion.com/help · Export your content; умови тарифів — notion.com/pricing
• Evernote: експорт нотаток у файл .enex (власний XML) — help.evernote.com · довідка, розділ про експорт нотаток; умови тарифів — evernote.com/compare-plans
• Кодування адрес: пробіл і не-ASCII символи в URL записуються відсотковими послідовностями — RFC 3986, розділ 2.1. datatracker.ietf.org · RFC 3986
• Формат дати РРРР-ММ-ДД — RFC 3339, профіль ISO 8601. datatracker.ietf.org · RFC 3339
• Правила української латинської транслітерації, за якими редактор підказує ім’я файлу — постанова Кабінету Міністрів України № 55 від 27.01.2010. zakon.rada.gov.ua · Постанова № 55
• Атомарність нотатки як принцип паперової картотеки (Zettelkasten) — zettelkasten.de · Introduction
• Чутливість файлових імен до регістру на Linux — man7.org · path_resolution(7)

Числа в прикладах нотаток (340 грн, 180 грн змінних витрат, 34 з 50 в опитуванні, 420 грн у конкурента) — ілюстративні. Вони складені так, щоб узгоджуватися між собою й з арифметикою уроку 4 (340 − 180 = 160). Із реального дослідження вони не походять. У своїх нотатках підставляєш власні числа зі свого data/market.csv. Довжина адреси 76 проти 22 символів порахована для конкретних імен Аналіз ринку.md і market-analysis.md. Оцінки трьох інструментів у матриці стосуються моделі роботи, а не якості застосунків. Конкретних лімітів безкоштовних тарифів тут свідомо немає: вони змінюються, і їх звіряють за посиланнями вище. Повний перелік джерел із поясненнями — у файлі urok-07-джерела.md поруч із цією сторінкою.