Руководство по Markdown

OwnSpace использует Markdown как формат заметок. Это руководство описывает синтаксис и специальные возможности редактора.

Базовое форматирование

# Заголовок 1
## Заголовок 2
### Заголовок 3

**жирный текст**
*курсив*
~~зачёркнутый~~

- маркированный список
- ещё один пункт

1. нумерованный список
2. второй пункт

> цитата

`встроенный код`

[ [вставка ссылки] ]

Ссылки

Wiki-ссылки

OwnSpace поддерживает [ [wiki-ссылки] ] для связи заметок:

[ [имя-файла] ]              — ссылка на другую заметку
[ [имя-файла|отображение] ]  — ссылка с произвольным текстом

При клике по wiki-ссылке открывается целевая заметка. Обратные ссылки отслеживаются автоматически — вы можете видеть, какие заметки ссылаются на текущую.

Внешние ссылки

[Google](https://google.com)
<https://example.com>

Блоки кода

Используйте тройные обратные кавычки:

```javascript
function hello() {
  console.log("Привет, мир!");
}
```

Таблицы

| Столбец 1  | Столбец 2  |
|------------|------------|
| Ячейка 1   | Ячейка 2   |
| Ячейка 3   | Ячейка 4   |

Изображения

OwnSpace поддерживает вставку изображений в заметки. Чтобы добавить изображение:

• Вставьте (Ctrl+V / Cmd+V) изображение из буфера обмена в редактор
• Перетащите файл изображения из проводника в редактор

При добавлении изображения OwnSpace:

1. Проверяет файл — поддерживаются PNG, JPEG, GIF, WebP, SVG (макс. 10 МБ)
2. Вычисляет SHA-256 хеш для автоматической дедупликации (дубликаты не загружаются повторно)
3. Сохраняет файл в папку attachments/ в локальном хранилище
4. Вставляет markdown-ссылку:

![](/attachments/img_a1b2c3d4.png)

Вы также можете написать ссылку вручную, используя тот же синтаксис.

Управляйте всеми прикреплёнными изображениями на странице Вложения (боковая панель → Вложения). Отображается размер, тип, какие заметки ссылаются на изображение и статус синхронизации. «Сиротские» изображения (на которые не ссылается ни одна заметка) подсвечиваются.

Визуальный редактор (WYSIWYG)

Нажмите Ctrl+E / Cmd+E для переключения в визуальный редактор (TipTap). Возможности:

• Слэш-команды: введите / для просмотра доступных блоков
• Перетаскивание блоков за ручку слева
• Форматирование текста через всплывающую панель

Визуальный редактор сохраняет в Markdown — вы можете свободно переключаться между режимами.

Редактор исходника (Source)

Нажмите Ctrl+Alt+E / Cmd+Alt+E для переключения в редактор исходного кода (plain text). Вы получаете полный контроль над raw Markdown в текстовом поле.

• Пишите Markdown-синтаксис напрямую — все возможности из этого руководства доступны
• Wiki-ссылки пишутся вручную: <a href="/ru/help/имя-файла">имя-файла</a> или <a href="/ru/help/имя-файла">отображение</a>
• Используйте Ctrl+Z / Cmd+Z для отмены

Вы можете свободно переключаться между визуальным редактором и исходником — содержимое остаётся в Markdown.