Obsidian это приложение для ведения заметок и базы знаний на основе Markdown.

На данный момент поддерживаются следующие элементы форматирования:

Внутренние ссылки¶

Ссылка на страницу: [[Создание внутренних ссылок]].

Ссылка на страницу: [[Создание внутренних ссылок]].

Вложенные файлы¶

Вложение другого файла (узнать больше о [[Встраивание вложений в заметки|встраивании вложений в заметки]]). Далее показан пример вложения раздела заметки об Obsidian:

![[Obsidian#Что такое Obsidian]]

![[Obsidian#Что такое Obsidian]]

Заголовки¶

# Это заголовок 1
## Это заголовок 2
### Это заголовок 3
#### Это заголовок 4
##### Это заголовок 5
###### Это заголовок 6

Это заголовок 1¶

Это заголовок 2¶

Это заголовок 3¶

Это заголовок 4¶

Это заголовок 5¶

Это заголовок 6¶

Выделение¶

*Этот текст будет выделен курсивом*
_Этот текст тоже будет выделен курсивом_

Этот текст отобразится курсивом Этот текст отобразится курсивом

**Этот текст будет выделен жирным шрифтом**
__Этот текст тоже будет выделен жирным шрифтом__

Этот текст будет выделен жирным шрифтом Этот текст тоже будет выделен жирным шрифтом

_Их **можно** комбинировать_

Их можно комбинировать

Списки¶

- Предмет 1
- Предмет 2
  - Предмет 2a
  - Предмет 2b

1. Предмет 1
1. Предмет 2
1. Предмет 3
   1. Предмет 3a
   1. Предмет 3b

Предмет 1
Предмет 2
Предмет 2a
Предмет 2b
Предмет 1
Предмет 2
Предмет 3
Предмет 3a
Предмет 3b

Изображения¶

![Энгельбарт](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)

Энгельбарт

Изменение размера изображений¶

Пример уменьшения размера верхнего изображения до 100 пикселей в ширину:

![Энгельбарт|100](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg)

Энгельбарт|100

Ссылки¶

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

Ссылки в формате Markdown можно использовать как для отсылки к внешним объектам вроде веб-страниц, так и к внутренним страницам или изображениям.

http://obsidian.md — создаются автоматически!
[Obsidian](http://obsidian.md)

http://obsidian.md — создаются автоматически! Obsidian

Ссылки Obsidian URI¶

Ссылки [[Использование Obsidian URI|Obsidian URI]] могут использоваться для открытия заметок из текущего хранилища, из другого хранилища или других программ.

Например, вы можете вставить ссылку на файл в хранилище следующим образом (обратите внимание на [[Использование Obsidian URI#Кодировка|обязательную кодировку]]):

[Ссылка на файл](obsidian://open?path=D:%2Fpath%2Fto%2Ffile.md)

Ссылка на файл

Вы так же можете вставить ссылку на файл указав имя хранилища и имя файла, без полного пути до него:

[Ссылка на файл](obsidian://open?vault=MainVault&file=MyNote.md)

Ссылка на файл

Экранирование¶

Если в ссылке есть пробелы, они могут быть экранированы. Например, с использованием кода %20 вместо пробелов:

[Импорт данных](Импорт%20данных)

Импорт данных

Или вы можете заключить цель в угловые скобки <>:

[Демонстрация слайдов](<Демонстрация слайдов>)

Демонстрация слайдов

Цитирование¶

> Люди сталкиваются со всё более сложными и неотложными проблемами, и их эффективность в решении этих проблем имеет решающее значение для стабильности и дальнейшего прогресса общества.

\- Дуглас Энгельбарт, 1961

Люди сталкиваются со всё более сложными и неотложными проблемами, и их эффективность в решении этих проблем имеет решающее значение для стабильности и дальнейшего прогресса общества.

- Дуглас Энгельбарт, 1961

Встроенный код¶

Текст внутри `обратных кавычек` в строке будет отображаться как код.

Текст внутри обратных кавычек в строке будет отображаться как код.

Блоки кода¶

Подсветка синтаксиса кода поддерживается путем указания языка после первых трех обратных кавычек. Для подсветки мы используем библиотеку PrismJS, список поддерживаемых языков можно найти на их сайте.

```js
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
```

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

    Текст с отступом, сделанным с помощью табуляции, будет
    выглядеть как блок кода в области предварительного просмотра.

Текст с отступом, сделанным с помощью табуляции, будет выглядеть как блок кода в области предварительного просмотра.

Список задач¶

- [x] поддерживаются #теги, [ссылки](), **форматирование**
- [x] используется синтаксис списка (поддерживаются упорядоченный или не упорядоченный списки)
- [x] это завершенная задача
- [?] это тоже завершенная задача (работает с любым символом)
- [ ] это незавершенная задача
- [ ] задачи в области предварительного просмотра помечаются завершенными при нажатии на чекбокс

поддерживаются #теги, ссылки, форматирование
используется синтаксис списка (поддерживаются упорядоченный или не упорядоченный списки)
это завершенная задача
[?] это тоже завершенная задача (работает с любым символом)
это незавершенная задача
задачи в области предварительного просмотра помечаются завершенными при нажатии на чекбокс

Таблицы¶

Вы можете создавать таблицы из списков слов. Шапка таблицы (первая строка) отделяется от остальных строк дефисами -. Столбцы разделяются вертикальной чертой |:

Первый заголовок | Второй заголовок
------------ | ------------
Первый заголовок | Содержимое второй ячейки
Содержимое первой колонки | Содержимое второй колонки

Первый заголовок	Второй заголовок
Первый заголовок	Содержимое второй ячейки
Содержимое первой колонки	Содержимое второй колонки

В таблицах поддерживается выравнивание | Пример выравнивания
:------------|------------:
по краю с использованием двоеточия `:` | по правому краю

В таблицах поддерживается выравнивание	Пример выравнивания
по краю с использованием двоеточия `:`	по правому краю

В таблицах работаю ссылки. Если в ссылке используется вертикальная черта |, она должна быть изолирована символом \, чтобы не быть распознанной как элемент таблицы.

Первый заголовок | Второй заголовок
------------ | ------------
[[Форматирование заметок\|Форматирование]] | [[Сочетания клавиш\|Горячие клавиши]]

Первый заголовок	Второй заголовок
[[Форматирование заметок\|Форматирование]]	[[Сочетания клавиш\|Горячие клавиши]]

Зачеркивание¶

Любой текст заключенный в двойные тильды (например, ~~так~~) будет отображаться как зачеркнутый.

Любой текст заключенный в двойные тильды (например, ~~так~~) будет отображаться как зачеркнутый.

Подсветка¶

Используя двойные знаки равенства можно ==подсветить текст==.

Используя двойные знаки равенства можно подсветить текст.

Сноски¶

Пример простой сноски[^1] и пример сноски подлиннее[^большая_сноска].

[^1]: со смыслом!

[^большая_сноска]: с несколькими абзацами и кодом.

    Делайте отступ перед абзацем, чтобы включить его в сноску.

    `{ мой код }`

    Абзацев может быть сколько угодно.

Пример простой сноски¹ и пример сноски подлиннее².

Сноски также можно оставлять прямо в тексте.^[обратите внимание, что карет `^` при этом выносится за скобки.]

Сноски также можно оставлять прямо в тексте.^[обратите внимание, что карет ^ при этом выносится за скобки.]

Математические формулы¶

Для отображения формулы в отдельном блоке, необходимо заключить ее в двойные $$:

$$\begin{vmatrix}a & b\\
c & d
\end{vmatrix}=ad-bc$$

\[\begin{vmatrix}a & b\\ c & d \end{vmatrix}=ad-bc\]

Так же возможно отображение формулы внтури строки $e^{2i\pi} = 1$.

Так же возможно отображение формулы внутри строки $e^{2i\pi} = 1$.

Obsidian использует библиотеку Mathjax для отображения математических формул. Вы можете ознакомиться со списком расширений поддерживаемых в Mathjax тут.

Комментарии¶

Используйте двойные %% для вложения комментариев, которые будут распознаны как текст Markdown, но не будут показаны в режиме предварительного просмотра.

Комментарий внутри текста: %%скрытый комментарий%% (который, не виден в режиме предварительного просмотра)

Скрытый блок с комментариями: (который, так же не виден в режиме предварительного просмотра)
%%
Он может содержать
множество строк
%%

Комментарий внутри текста: %%скрытый комментарий%% (который, не виден в режиме предварительного просмотра)

Скрытый блок с комментариями: (который, так же не виден в режиме предварительного просмотра) %% Он может содержать множество строк %%

Диаграммы¶

Obsidian использует библиотеку Mermaid для отображения диаграмм и схем. У Mermaid есть удобный «живой редактор».

```mermaid
sequenceDiagram
    Алиса->>+Иван: Привет Иван, как ты?
    Алиса->>+Иван: Иван, ты меня слышишь?
    Иван-->>-Алиса: Привет Алиса, я тебя слышу!
    Иван-->>-Алиса: Я чувствую себя отлично!
```

sequenceDiagram
    Алиса->>+Иван: Привет Иван, как ты?
    Алиса->>+Иван: Иван, ты меня слышишь?
    Иван-->>-Алиса: Привет Алиса, я тебя слышу!
    Иван-->>-Алиса: Я чувствую себя отлично!

Obsidian поддерживает ссылки на заметки внутри элементов Mermaid:

```mermaid
graph TD

Биология --> Химия

class Биология,Химия internal-link;
```

Второй, но более простой способ: ^376b9d

```mermaid
graph TD

A[Биология]
B[Химия]

A --> B

class A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z internal-link;
```

Таким образом, все имена заметок (по крайней мере до Z[имя заметки]) автоматически присваиваются к классу internal-link при использовании этого фрагмента.

Если вы используете специальные символы в названиях заметок, то вам нужно заключать их в двойные кавычки: "⨳ специальный символ"

Во [[Форматирование заметок#^376b9d|втором способе]] это делается следующим образом: A["⨳ специальный символ"]

Примечания разработчика¶

Мы стараемся соблюсти максимальную совместимость не нарушая существующие форматы, поэтому мы используем слегка необщепринятый комбинацию разновидностей Markdown. В общих чертах это CommonMark с добавлением некоторых возможностей из GitHub Flavored Markdown (GFM), с частичной поддержкой LaTeX и выбранным нами синтаксисом для вложений, о котором можно почитать тут: [[поддерживаемые форматы файлов]].

со смыслом! ↩
с несколькими абзацами и кодом.

Делайте отступ перед абзацем, чтобы включить его в сноску.

{ мой код }

Абзацев может быть сколько угодно. ↩