Obsidian Flavored Markdown

Создавайте и редактируйте корректный Obsidian Flavored Markdown. Obsidian расширяет CommonMark и GFM вики-ссылками, встраиваниями, callout-блоками, свойствами, комментариями и другим синтаксисом. Этот скилл покрывает только специфичные расширения Obsidian — стандартный Markdown (заголовки, жирный, курсив, списки, цитаты, код-блоки, таблицы) предполагается известным.

Процесс: создание заметки Obsidian

1. Добавьте фронтматтер со свойствами (title, tags, aliases) в начале файла. См. PROPERTIES.md.
2. Напишите контент стандартным Markdown для структуры плюс специфичный синтаксис Obsidian ниже.
3. Свяжите заметки вики-ссылками ([[Note]]) для внутренних связей хранилища или обычными Markdown-ссылками для внешних URL.
4. Встраивайте контент из других заметок, изображений или PDF через синтаксис ![[embed]]. См. EMBEDS.md.
5. Добавляйте callout-блоки для выделенной информации через > [!type]. См. CALLOUTS.md.
6. Проверьте, что заметка корректно отображается в режиме чтения Obsidian.

Выбирая между вики-ссылками и Markdown-ссылками: используйте [[wikilinks]] для заметок внутри хранилища (Obsidian автоматически отслеживает переименования) и [text](url) только для внешних URL.

Внутренние ссылки (вики-ссылки)

[[Note Name]]                          Link to note
[[Note Name|Display Text]]             Custom display text
[[Note Name#Heading]]                  Link to heading
[[Note Name#^block-id]]                Link to block
[[#Heading in same note]]              Same-note heading link

Задайте ID блока, добавив ^block-id к любому абзацу:

This paragraph can be linked to. ^my-block-id

Для списков и цитат размещайте ID блока на отдельной строке после блока:

> A quote block

^quote-id

Встраивания (embeds)

Добавьте ! перед любой вики-ссылкой, чтобы встроить её контент:

![[Note Name]]                         Embed full note
![[Note Name#Heading]]                 Embed section
![[image.png]]                         Embed image
![[image.png|300]]                     Embed image with width
![[document.pdf#page=3]]               Embed PDF page

Аудио, видео, поисковые встраивания и внешние изображения — см. EMBEDS.md.

Callout-блоки

> [!note]
> Basic callout.

> [!warning] Custom Title
> Callout with a custom title.

> [!faq]- Collapsed by default
> Foldable callout (- collapsed, + expanded).

Частые типы: note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, todo. Полный список с псевдонимами, вложенностью и кастомными CSS-callout — в CALLOUTS.md.

Свойства (фронтматтер)

---
title: My Note
date: 2024-01-15
tags:
  - project
  - active
aliases:
  - Alternative Name
cssclasses:
  - custom-class
---

Свойства по умолчанию: tags (искомые метки), aliases (альтернативные имена заметки для подсказок ссылок), cssclasses (CSS-классы для стилизации). Подробнее — в PROPERTIES.md.

Теги

#tag                    Inline tag
#nested/tag             Nested tag with hierarchy

Теги могут содержать буквы, цифры (не первым символом), подчёркивания, дефисы и прямые слеши. Теги также можно задавать во фронтматтере под свойством tags.

Комментарии

This is visible %%but this is hidden%% text.

%%
This entire block is hidden in reading view.
%%

Специфичное форматирование Obsidian

==Highlighted text==                   Highlight syntax

Математика (LaTeX)

Inline: $e^{i\pi} + 1 = 0$

Block:
$$
\frac{a}{b} = c
$$

Диаграммы (Mermaid)

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
```

Чтобы связать узлы Mermaid с заметками Obsidian, добавьте class NodeName internal-link;.

Сноски

Text with a footnote[^1].

[^1]: Footnote content.

Inline footnote.^[This is inline.]

Полный пример

---
title: Project Alpha
date: 2024-01-15
tags:
  - project
  - active
status: in-progress
---

# Project Alpha

This project aims to [[improve workflow]] using modern techniques.

> [!important] Key Deadline
> The first milestone is due on ==January 30th==.

## Tasks
- [x] Initial planning
- [ ] Development phase
  - [ ] Backend implementation
  - [ ] Frontend design

## Notes
The algorithm uses $O(n \log n)$ sorting. See [[Algorithm Notes#Sorting]] for details.

![[Architecture Diagram.png|600]]

Reviewed in [[Meeting Notes 2024-01-10#Decisions]].

Ссылки

• Obsidian Flavored Markdown
• Internal links
• Embed files
• Callouts
• Properties