Клавиатура Markdown для Obsidian онлайн: вики-ссылки и выноски
Вики-ссылки, выноски и прочий мелкий синтаксис, из которого состоит хранилище.
Предпросмотр
Предпросмотр примерный: он показывает смысл разметки, а не то, как её нарисует конкретное приложение. Шрифты, цвета и отступы везде свои, а часть возможностей зависит от версии.
0 симв.
Что пишет каждая кнопка
| Действие | Синтаксис | Примечание |
|---|---|---|
| B | **bold** |
Жирный |
| I | *italic* |
Курсив |
| S | ~~strikethrough~~ |
Зачёркнутый |
| Mark | ==highlight== |
Выделение маркером - расширение Obsidian |
| Code | `code` |
Код в строке |
| Comment | %%hidden note%% |
Комментарий - виден в редакторе, скрыт в режиме чтения |
| Wiki link | [[Note name]] |
Ссылка на другую заметку - из таких строится граф |
| Embed | ![[Note name]] |
Встроить содержимое другой заметки или файла |
| Heading link | [[Note#Heading]] |
Ссылка на заголовок внутри заметки |
| Block id | ^block-id |
Дать блоку id, чтобы на него можно было сослаться |
| Tag | #tag |
Тег - без пробела после решётки |
| H1 | # Heading |
Заголовок |
| H2 | ## Heading |
Заголовок раздела |
| Task | - [ ] to do |
Задача |
| List | - item |
Маркированный список |
| Quote | > quoted |
Цитата |
| Callout | > [!note] |
Выноска: note, tip, warning, danger, example и другие |
| Code block | ```js
code
``` |
Блок кода |
| Properties | ---
tags:
--- |
Свойства заметки - должны стоять в самом начале файла |
Телефон собирает файл приложения - поэтому это дольше обычной загрузки.
Ищите этот значок: Obsidian
Два вида ссылок, и граф строит только один
Markdown-ссылка ведёт на адрес. Вики-ссылка в двойных квадратных скобках ведёт на другую заметку хранилища, и именно из таких ссылок строятся граф, обратные ссылки и упоминания. [[Заметка]] вместо обычной ссылки превращает папку с файлами в связанное хранилище.
Синтаксис, из которого состоит хранилище
Внутри Obsidian обычный Markdown, а сверху несколько добавок для связей: вики-ссылки, встраивание одной заметки в другую, id блоков для ссылки на конкретный абзац и теги. Заголовки, списки, задачи и код пишутся как везде.
Выноски похожи на оповещения GitHub, но тип пишется строчными буквами, а типов больше: note, tip, warning, danger, example, quote и другие. В другом редакторе выноска станет обычной цитатой. Комментарии в двойных знаках процента видны в редакторе, но пропадают в режиме чтения и при экспорте.
Как пользоваться
- Напишите заметку здесь. Готовый текст вставьте в хранилище, разметка - это обычный текст.
- Ставьте ссылки в двойных скобках. Внутри точное имя заметки, а несуществующая заметка станет ссылкой на будущую.
- Свойства ставьте в самое начало. Блок должен идти первым в файле, иначе это просто текст.
- Скопируйте текст в хранилище. Нажмите "Копировать всё" и вставьте в заметку, на сервер ничего не отправляется.
Вопросы и ответы
Вики-ссылки или Markdown-ссылки?
Вики-ссылки внутри хранилища, Markdown-ссылки на внешние сайты. Obsidian можно настроить на Markdown-ссылки и для заметок, это удобно, если файлы правятся в других приложениях.
Выноски сохранятся вне Obsidian?
Они превратятся в цитату с видимым типом в скобках. Текст останется читаемым.
Зачем нужен id блока?
Чтобы другая заметка могла сослаться на один абзац, а не на всю заметку. Кнопка пишет id вручную, если вы заранее знаете, что абзац будут цитировать.
Свойства обязательно в YAML?
Да, блок между строками из трёх дефисов - это YAML, и он должен стоять первым в файле. Пустая строка над ним превращает весь блок в видимый текст.
