Разметка и спецблоки
Заметки размечаются обычным Markdown. Поверх него — формулы KaTeX, подсветка кода и три спецблока: график, встраивание и Python.
Шпаргалка по Markdown
| Пишете | Получаете |
|---|---|
# Заголовок … ###### Заголовок | Заголовки шести уровней |
**жирный**, *курсив*, ~~зачёркнутый~~ | жирный, курсив, |
- пункт / 1. пункт | Маркированный / нумерованный список |
> текст | Цитата |
`код` | Код в строке |
```python … ``` | Блок кода с подсветкой языка |
[текст](https://…) | Ссылка |
 | Картинка |
| а | б | | Таблица |
--- | Горизонтальная линия |
Несколько удобных особенностей:
- обычный перенос строки — это перенос строки (не нужно две в конце);
- голые ссылки вида
https://example.comстановятся кликабельными сами; - HTML-теги в тексте не исполняются — показываются как текст (это защита, а не недоработка).
Формулы KaTeX
Формулы пишутся в синтаксисе LaTeX:
$…$— формула в строке:Энергия $E = mc^2$ покоя;$$…$$— выключная формула: отдельной строкой по центру, даже если стоит внутри абзаца. Длинные формулы прокручиваются, не распирая страницу.
$$\int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi}$$
Кнопка «√x» в тулбаре обрамляет выделенное в $…$.
Подсветка кода
Укажите язык после открывающих кавычек блока кода — и в предпросмотре, печати и на публичных страницах он подсветится. Поддерживаются популярные языки: Python, JavaScript/TypeScript, PHP, SQL, Bash, JSON, HTML/CSS и другие.
График: ```chart
Блок с языком chart и JSON-описанием внутри превращается
в интерактивный график Chart.js. Кнопка «график» в тулбаре вставляет
готовый шаблон:
```chart
{
"type": "line",
"data": {
"labels": ["янв", "фев", "мар", "апр"],
"datasets": [{ "label": "Пробежки, км", "data": [12, 19, 8, 24] }]
}
}
```
Поддерживаются типы Chart.js: line, bar, pie, doughnut, radar, scatter и другие — формат данных смотрите в документации Chart.js. Графики работают и при экспорте в PDF.
Встраивание: ```embed
Блок embed с адресом внутри встраивает интерактивную рамку.
Из соображений безопасности разрешены только два сайта:
desmos.com (графический калькулятор) и
geogebra.org (интерактивная математика).
```embed
https://www.desmos.com/calculator/abcd1234
```
Python в заметке: ```python
У каждого блока python в предпросмотре появляется кнопка
запуска. Код исполняется прямо в вашем браузере (через
Pyodide/WebAssembly) — на сервер ничего не отправляется. Результат
печатается под блоком; графики matplotlib превращаются в картинки.
```python
import numpy as np
x = np.linspace(0, 10, 100)
print(x.mean())
```
- «Из коробки» доступны numpy, matplotlib, pandas, scipy и ещё ~250 пакетов — они подгружаются сами по импортам.
- Первый запуск скачивает интерпретатор (~10 МБ, с пакетами больше) — дальше он кэшируется.
- Python работает и на публичных страницах: читатель вашей заметки может запустить код у себя в браузере.
Все спецблоки безопасны по построению: график читает только JSON, рамка ограничена двумя доверенными сайтами, а Python исполняется в песочнице браузера, без доступа к серверу и вашим заметкам.