====== Шпаргалка по разметке DokuWiki (Мои правила) ======

Эта страница — моя личная инструкция по форматированию, созданная на основе долгой и мучительной отладки. Цель — никогда больше не тратить часы на исправление "сбившегося" форматирования.

===== Золотые Правила (Самое важное!) =====

  * **Правило №1: Один элемент — одна строка.** Каждый заголовок, пункт списка или блок кода должен начинаться с новой строки.
  * **Правило №2: Два пробела для списка.** Чтобы создать пункт списка, нужно поставить **два пробела** перед звездочкой (`*`).
  * **Правило №3: Пустая строка — новый абзац.** Чтобы начать новый абзац, нужно оставить между ними одну пустую строку.

===== Основные Элементы Разметки =====

==== Заголовки ====

Чем больше знаков `=`, тем меньше заголовок.

<code wiki>
====== Заголовок 1 (Обычно название страницы) ======
===== Заголовок 2 (Крупный раздел) =====
==== Заголовок 3 (Подраздел) ====
</code>

==== Форматирование текста ====

  * **Жирный:** `**Жирный текст**` -> **Жирный текст**
  * **Курсив:** `//Курсив//` -> //Курсив//
  * **Подчеркнутый:** `__Подчеркнутый__` -> __Подчеркнутый__
  * **Моноширинный:** `''Моноширинный (для команд и файлов)''` -> ''Моноширинный (для команд и файлов)''

==== Списки ====

//Не забывать про ДВА пробела перед звездочкой!//

<code wiki>
  * Уровень 1
    * Уровень 2 (четыре пробела)
  * Уровень 1
</code>

==== Ссылки ====

{{note>Чтобы внутренние ссылки ниже заработали, создайте две страницы: [[example_page_1]] и [[example_page_2]]. Код для них — в Шаге 2 этой инструкции.}}

  * **Внутренняя ссылка на страницу:** `[[пример_страницы_1]]`
  * **Внутренняя ссылка с другим текстом:** `[[example_page_2|Это ссылка с другим текстом]]`
  * **Внешняя ссылка:** `[[https://www.google.com|Поиск в Google]]`

==== Блоки кода ====

Для подсветки синтаксиса нужно указать язык (bash, sql, python и т.д.).

<code wiki>
<code bash>
# Комментарий в Bash
sudo apt update && sudo apt upgrade -y
</code>

==== Другие полезные вещи ====

  * **Горизонтальная линия:** `----`
  * **Принудительный перенос строки:** `Текст \\ новая строка`
  * **Блок-заметка:** `{{note>Текст важной заметки}}`