Узнайте, как применять основное форматирование к заметкам с помощью [Markdown](https://daringfireball.net/projects/markdown/). Для изучения расширенного синтаксиса форматирования обратитесь к разделу [[Расширенный синтаксис форматирования]]. ## Абзацы Чтобы создать абзацы в Markdown, используйте **пустую строку** для разделения блоков текста. Каждый блок текста, отделённый пустой строкой, рассматривается как отдельный абзац. ```md Это абзац. Это другой абзац. ``` Это абзац. Это другой абзац. Пустая строка между строками текста создаёт отдельные абзацы. Это поведение по умолчанию в Markdown. > [!tip]- Множественные пробелы > Множественные последовательные пробелы внутри абзацев и между ними сворачиваются в один пробел при отображении в [[Режимы просмотра и редактирования#Режим чтения|режиме чтения]] или на сайтах [[Введение в Obsidian Publish|Obsidian Publish]]. > > ```md > Множественные последовательные пробелы > > > > и множественные переносы строк между абзацами. > ``` > > > Множественные последовательные пробелы > > > > > > > > и множественные переносы строк между абзацами. > > Если вы хотите предотвратить сворачивание пробелов или добавить несколько пустых пробелов, можно использовать HTML-теги `&nbsp;` (неразрывный пробел) или `<br>` (перенос строки). ### Переносы строк По умолчанию в Obsidian одно нажатие `Enter` создаёт новую строку в заметке, но при отображении она рассматривается как *продолжение* того же абзаца, в соответствии с типичным поведением Markdown. Чтобы вставить перенос строки *внутри* абзаца без начала нового абзаца, вы можете: - Добавить **два пробела** в конце строки перед нажатием `Enter`, или - Использовать сочетание клавиш `Shift+Enter` для прямой вставки переноса строки. > [!question]- Почему множественные нажатия `Enter` не создают больше переносов строк в режиме чтения? > В Markdown одиночный `Enter` игнорируется, а множественные последовательные нажатия `Enter` приводят лишь к одному новому абзацу. Это поведение соответствует правилу мягкого переноса Markdown, где дополнительные пустые строки не генерируют дополнительных переносов строк или абзацев — они сворачиваются в один разрыв абзаца. Именно так Markdown обрабатывает текст по умолчанию, обеспечивая естественное перетекание абзацев без неожиданных разрывов. В Obsidian есть настройка **[[Настройки#Двойной разделитель строк|Двойной разделитель строк]]**, которая заставляет Obsidian следовать стандартной спецификации Markdown для переносов строк. Чтобы включить эту функцию: 1. Откройте **[[Настройки]]**. 2. Перейдите на вкладку **Редактор**. 3. Включите **Двойной разделитель строк**. Когда **Двойной разделитель строк** включён в Obsidian, переносы строк имеют три различных поведения в зависимости от того, как строки разделены: **Одиночный возврат без пробелов**: Одиночный `Enter` без завершающих пробелов объединит две отдельные строки в одну при отображении. ```md строка один строка два ``` Отображается как: строка один строка два **Одиночный возврат с двумя или более завершающими пробелами**: Если вы добавите два или более пробела в конце первой строки перед нажатием `Enter`, две строки останутся частью одного абзаца, но будут разделены переносом строки (HTML-элемент `<br>`). В этом примере мы используем два символа подчёркивания вместо пробелов. ```md строка три__ строка четыре ``` Отображается как: строка три<br> строка четыре **Двойной возврат (с завершающими пробелами или без)**: Двойное (или более) нажатие `Enter` разделяет строки на два отдельных абзаца (HTML-элементы `<p>`), независимо от того, добавлены ли пробелы в конце первой строки. ```md строка пять строка шесть ``` Отображается как: <p>строка пять</p> <p>строка шесть</p> ## Заголовки Чтобы создать заголовок, добавьте до шести символов `#` перед текстом заголовка. Количество символов `#` задаёт уровень заголовка (как показано в [[Структура|структуре]]). ```md # Это заголовок 1 ## Это заголовок 2 ### Это заголовок 3 #### Это заголовок 4 ##### Это заголовок 5 ###### Это заголовок 6 ``` %% These headings use HTML to avoid cluttering the Outline/Table of contents %% <h1>Это заголовок 1</h1> <h2>Это заголовок 2</h2> <h3>Это заголовок 3</h3> <h4>Это заголовок 4</h4> <h5>Это заголовок 5</h5> <h6>Это заголовок 6</h6> ## Жирный, курсив, выделение Форматирование текста также можно применять с помощью [[Сочетания клавиш при редактировании|сочетаний клавиш при редактировании]]. | Стиль | Синтаксис | Пример | Результат | |-|-|-|-| | Жирный | `** **` или `__ __` | `**Жирный текст**` | **Жирный текст** | | Курсив | `* *` или `_ _` | `*Курсивный текст*` | *Курсивный текст* | | Зачёркнутый | `~~ ~~` | `~~Зачёркнутый текст~~` | ~~Зачёркнутый текст~~ | | Выделение | `== ==` | `==Выделенный текст==` | ==Выделенный текст== | | Жирный и вложенный курсив | `** **` и `_ _` | `**Жирный текст и _вложенный курсив_ текст**` | **Жирный текст и _вложенный курсив_ текст** | | Жирный и курсив | `*** ***` или `___ ___` | `***Жирный и курсивный текст***` | ***Жирный и курсивный текст*** | Форматирование можно принудительно отобразить как обычный текст, добавив обратную косую черту `\` перед ним. \*\*Эта строка не будет жирной\*\* ```markdown \*\*Эта строка не будет жирной\*\* ``` \**Эта строка будет курсивной и покажет звёздочки*\* ```markdown \**Эта строка будет курсивной и покажет звёздочки*\* ``` ## Внутренние ссылки Obsidian поддерживает два формата [[Внутренние ссылки|внутренних ссылок]] между заметками: - Wiki-ссылка: `[[Три закона движения]]` - Markdown: `[Три закона движения](Три%20закона%20движения.md)` ## Внешние ссылки Если вы хотите создать ссылку на внешний URL, вы можете создать встроенную ссылку, заключив текст ссылки в квадратные скобки (`[ ]`), а затем URL в круглые скобки (`( )`). ```md [Справка Obsidian](https://help.obsidian.md) ``` [Справка Obsidian](https://help.obsidian.md) Вы также можете создавать внешние ссылки на файлы в других хранилищах, используя [[Obsidian URI|Obsidian URI]]. ```md [Заметка](obsidian://open?vault=MainVault&file=Note.md) ``` ### Экранирование пробелов в ссылках Если ваш URL содержит пробелы, вы должны экранировать их, заменив на `%20`. ```md [Моя заметка](obsidian://open?vault=MainVault&file=My%20Note.md) ``` Вы также можете экранировать URL, заключив его в угловые скобки (`< >`). ```md [Моя заметка](<obsidian://open?vault=MainVault&file=My Note.md>) ``` ## Внешние изображения Вы можете добавлять изображения с внешних URL, добавив символ `!` перед [[#Внешние ссылки|внешней ссылкой]]. ```md  ```  Вы можете изменить размеры изображения, добавив `|640x480` к назначению ссылки, где 640 — ширина, а 480 — высота. ```md  ``` Если вы укажете только ширину, изображение масштабируется с сохранением оригинального соотношения сторон. Например: ```md  ``` > [!tip]- Подсказка > Если вы хотите добавить изображение из вашего хранилища, вы также можете [[Встраивание файлов#Встраивание изображения в заметку|встроить изображение в заметку]]. ## Цитаты Вы можете цитировать текст, добавив символ `>` перед текстом. ```md > Люди сталкиваются со всё более сложными и неотложными проблемами, и их эффективность в решении этих проблем имеет критическое значение для стабильности и дальнейшего прогресса общества. \- Даг Энгельбарт, 1961 ``` > Люди сталкиваются со всё более сложными и неотложными проблемами, и их эффективность в решении этих проблем имеет критическое значение для стабильности и дальнейшего прогресса общества. \- Даг Энгельбарт, 1961 > [!tip]- Подсказка > Вы можете превратить цитату в [[Выноски|выносной блок]], добавив `[!info]` в качестве первой строки цитаты. ## Списки Вы можете создать маркированный список, добавив `-`, `*` или `+` перед текстом. ```md - Первый элемент списка - Второй элемент списка - Третий элемент списка ``` - Первый элемент списка - Второй элемент списка - Третий элемент списка Чтобы создать нумерованный список, начинайте каждую строку с числа, за которым следует символ `.` или `)`. ```md 1. Первый элемент списка 2. Второй элемент списка 3. Третий элемент списка ``` 1. Первый элемент списка 2. Второй элемент списка 3. Третий элемент списка ```md 1) Первый элемент списка 2) Второй элемент списка 3) Третий элемент списка ``` 1) Первый элемент списка 2) Второй элемент списка 3) Третий элемент списка Вы можете использовать `Shift+Enter` для вставки [[#Переносы строк|переноса строки]] внутри нумерованного списка без изменения нумерации. ```md 1. Первый элемент списка 2. Второй элемент списка 3. Третий элемент списка 4. Четвёртый элемент списка 5. Пятый элемент списка 6. Шестой элемент списка ``` ### Списки задач Чтобы создать список задач, начинайте каждый элемент списка с дефиса и пробела, за которыми следует `[ ]`. ```md - [x] Это выполненная задача. - [ ] Это невыполненная задача. ``` - [x] Это выполненная задача. - [ ] Это невыполненная задача. Вы можете переключить состояние задачи в режиме чтения, нажав на флажок. > [!tip]- Подсказка > Вы можете использовать любой символ внутри скобок, чтобы отметить задачу как выполненную. > > ```md > - [x] Молоко > - [?] Яйца > - [-] Яйца > ``` > > - [x] Молоко > - [?] Яйца > - [-] Яйца ### Вложенные списки Вы можете вкладывать любой тип списка — нумерованный, маркированный или список задач — в любой другой тип списка. Чтобы создать вложенный список, сделайте отступ для одного или нескольких элементов списка. Вы можете смешивать типы списков во вложенной структуре: ```md 1. Первый элемент списка 1. Вложенный нумерованный элемент 2. Второй элемент списка - Вложенный маркированный элемент ``` 1. Первый элемент списка 1. Вложенный нумерованный элемент 2. Второй элемент списка - Вложенный маркированный элемент Аналогично можно создать вложенный список задач, сделав отступ для одного или нескольких элементов списка: ```md - [ ] Задача 1 - [ ] Подзадача 1 - [ ] Задача 2 - [ ] Подзадача 1 ``` - [ ] Задача 1 - [ ] Подзадача 1 - [ ] Задача 2 - [ ] Подзадача 1 Используйте `Tab` или `Shift+Tab` для увеличения или уменьшения отступа выделенных элементов списка для удобной организации. ## Горизонтальная линия Вы можете использовать три или более звёздочки `***`, дефиса `---` или символа подчёркивания `___` на отдельной строке, чтобы добавить горизонтальную линию. Вы также можете разделять символы пробелами. ```md *** **** * * * --- ---- - - - ___ ____ _ _ _ ``` *** ## Код Вы можете форматировать код как встроенный внутри предложения, так и в виде отдельного блока. ### Встроенный код Вы можете форматировать код внутри предложения с помощью одиночных обратных кавычек. ```md Текст внутри `обратных кавычек` в строке будет отформатирован как код. ``` Текст внутри `обратных кавычек` в строке будет отформатирован как код. Если вы хотите поместить обратные кавычки во встроенный блок кода, окружите его двойными обратными кавычками: встроенный ``код с обратной кавычкой ` внутри``. ### Блоки кода Чтобы отформатировать код как блок, заключите его в три или более обратных кавычек или три или более тильд. ~~~ ````` cd ~/Desktop ````` ~~~ ````` ~~~ cd ~/Desktop ~~~ ````` `````md cd ~/Desktop ````` Вы также можете создать блок кода, сделав отступ текста с помощью `Tab` или 4 пробелов. `````md cd ~/Desktop ````` Вы можете добавить подсветку синтаксиса к блоку кода, указав код языка после первого набора обратных кавычек. ~~~md `````js function fancyAlert(arg) { if(arg) { $.facebox({div:'#foo'}) } } ````` ~~~ `````js function fancyAlert(arg) { if(arg) { $.facebox({div:'#foo'}) } } ````` Obsidian использует Prism для подсветки синтаксиса. Для получения дополнительной информации обратитесь к разделу [Поддерживаемые языки](https://prismjs.com/#supported-languages). > [!info]+ PrismJS и режимы редактирования > [[Режимы просмотра и редактирования#Режим исходного кода|Режим исходного кода]] и [[Режимы просмотра и редактирования#Динамический просмотр|Динамический просмотр]] не поддерживают PrismJS и могут отображать подсветку синтаксиса иначе. #### Вложенные блоки кода Когда вам нужно включить блок кода внутри другого блока кода (например, при документировании использования блоков кода), вы можете использовать более трёх обратных кавычек или тильд для внешнего блока кода. Чтобы вложить блоки кода, используйте четыре или более обратных кавычек (или тильд) для внешнего блока, а внутренний блок использует три: `````md ````md Вот как создать блок кода: ```js console.log("Hello world") ``` ```` ````` Вы также можете чередовать обратные кавычки и тильды. Это особенно полезно при работе с кодом, который генерирует другие блоки кода: `````md ````md ```dataviewjs dv.paragraph(` ~~~mermaid graph TD A --> B ~~~ `) ``` ```` ````` Ключевой принцип заключается в том, что внешний блок кода должен использовать **больше** символов ограждения (обратных кавычек или тильд), чем любой внутренний блок кода, или использовать другой тип символа ограждения. ## Сноски Вы можете добавлять сноски[^footnote] к заметкам, используя следующий синтаксис: [^footnote]: Это сноска. ```md Это простая сноска[^1]. [^1]: Это текст сноски. [^2]: Добавьте 2 пробела в начале каждой новой строки. Это позволяет писать сноски, занимающие несколько строк. [^note]: Именованные сноски по-прежнему отображаются как числа, но могут упростить идентификацию и связывание ссылок. ``` Вы также можете использовать встроенные сноски в предложении. Обратите внимание, что символ каретки размещается за пределами скобок. ```md Вы также можете использовать встроенные сноски. ^[Это встроенная сноска.] ``` > [!note] Примечание > Встроенные сноски работают только в режиме чтения, но не в динамическом просмотре. Используйте [[Панель сносок]], чтобы увидеть все сноски в заметке. ## Комментарии Вы можете добавлять комментарии, обернув текст символами `%%`. Комментарии видны только в режиме редактирования. ```md Это %%встроенный%% комментарий. %% Это блочный комментарий. Блочные комментарии могут занимать несколько строк. %% ``` ## Экранирование синтаксиса Markdown В некоторых случаях вам может понадобиться отобразить специальные символы Markdown, такие как `*`, `_` или `#`, без активации их форматирования. Чтобы отобразить эти символы буквально, поставьте обратную косую черту (`\`) перед ними. > [!example] Часто экранируемые символы > > - Звёздочка: `\*` > - Символ подчёркивания: `\_` > - Решётка: `\#` > - Обратная кавычка: `` \` `` > - Вертикальная черта (используется в таблицах): `\|` > - Тильда: `\~` ```md \*Этот текст не будет курсивным\*. ``` \*Этот текст не будет курсивным\*. При работе с нумерованными списками вам может понадобиться экранировать точку после числа, чтобы предотвратить автоматическое форматирование списка. Поставьте обратную косую черту (`\`) перед точкой, а **не** перед числом. ```md 1\. Это не будет элементом списка. ``` 1\. Это не будет элементом списка. ## Подробнее Чтобы узнать больше о расширенном синтаксисе форматирования, таком как таблицы, диаграммы и математические выражения, обратитесь к разделу [[Расширенный синтаксис форматирования]]. Чтобы узнать больше о том, как Obsidian обрабатывает Markdown, обратитесь к разделу [[Obsidian Flavored Markdown]].