Markdown – это способ форматирования текста и вставки изображений. [1] Он используется в Habitica во всех функциях чата во вкладке Общение, а также в заголовках и заметках задач, наград, и списков.
Изображения [2] вставляемые с помощью Markdown могут быть размещены на любых сайтах. (Emoji также можно использовать для вставки маленьких изображений без помощи Markdown, но выбор изображений ограничен.)
Обратите внимание, что в мобильных приложениях форматирование Markdown (показанная в таблице ниже) может отображаться не так, как ожидалось.
Как показано в таблице ниже, заголовки разных уровней могут быть созданы указанием перед текстом одним или несколькими # (хеш-метки). Наименьший заголовок использует шесть меток. Хеш-метки должны быть в начале строки и между ними должен быть пробел [3] и текст заголовка; В противном случае метки хеша останутся видимыми, и текст не будет увеличен. В чате используйте заголовки только тогда, когда они необходимы, поскольку они занимают много места.
| Отображаемое | Код разметки | Примечания |
|---|---|---|
| Заголовок 1 | # Заголовок 1 | Заголовки должны начинаться с новой строки |
| Заголовок 2 | ## Заголовок 2 | Они также занимают очень много места в окне |
| Заголовок 3 | ### Заголовок 3 | |
| Заголовок 4 | #### Заголовок 4 | Самый маленький заголовок – 6 знаков # |
| Текст курсивом | *Текст курсивом* _Текст курсивом_ |
_ можно заменить на * |
| Жирный текст | **Жирный текст** | |
| ~~Зачеркнутый текст~~ | ||
| Жирный текст курсивом | ***Жирный текст курсивом*** | |
| _Не курсив_
#Не заголовок# **Не жирный** |
\_Не курсив\_
\#Не заголовок\# \*\*Не жирный\*\* |
Если вы хотите написать символ, используемый в Markdown, поставьте перед ним обратный слэш |
|
`code` | Международные пользователи, у которых нет знака обратного апострофа (`) на клавиатуре, могут написать его с помощью комбинации клавиш "96" при удержании клавиши Alt. |
 |
> цитируемый текст | Множественный ввод ">" используется для многоуровневого цитирования. |
 |
После фразы "This is standard text", дважды нажмите Enter или Shift-Enter, чтобы начать новый абзац. Добавьте четыре пробела перед "This is a highlighted paragraph" | Используйте, чтобы выделить абзац |
  |
Напишите три обратных апострофа в новой строке (```). В следующих строках можете вводить код. Длинные абзацы НЕ будут свёртываться автоматически. Чтобы свернуть текст, как указано на картинке, необходимо вручную создать разрыв строки.
Нажмите "Enter" или "Shift-Enter", чтобы создать разрыв текста. Двойное нажатие "Enter" или "Shift-Enter" добавит пустую новую строку. Завершите блок кода тремя обратным апострофами (```). В отличие от предыдущего примера, в данном формате не требуется четыре пробела, чтобы начать новый абзац. |
Такие блоки отображаются как неотформатированный текст и как правило используются для демонстрации кода.
Международные пользователи, у которых нет знака обратного апострофа (`) на клавиатуре, могут написать его с помощью комбинации клавиш "96" при удержании клавиши Alt. |
| Строка текста Ещё одна строка текста под ней |
Двойное нажатие пробела в конце первой строки с последующим нажатием "Enter" или "Shift-Enter" разделит текст по строкам. | Введите текст, нажмите пробел дважды, перейдите на следующую строку и продолжайте вводитиь текст. |
| Строка текста
|
Двойное нажатие "Enter" или "Shift-Enter" в чате. Перед отправкой сообщения оно должно выгладеть следующим образом:
|
Ввод текста, пусткая строка, продолжение воода текста. |
| Прокладывание текста вручную |   в начале слова для ввода множественных пробелов между словами | Подходит для выравнивания заголовков заданий |
| • Жирные точки | Начните строку с "+" , "*" или "-" и пробела | Международные пользователи, у которых нет знака "+" на клавиатуре, могут написать его с помощью комбинации клавиш "43" с удержанием клавиши Alt. |
| 1. Упорядоченный список | Начните строку с "1." и пробела | |
| Горизонтальная линия | Двойной ввод "Enter" или "Shift-Enter", три знака тире (---), снова двойной ввод "Enter" или "Shift-Enter" в чате для создания горизонтальной линии. Как вариант нажмите "Enter" или "Shift-Enter" один раз, введите тройное нижнее подчёркивание (___), и снова "Enter" или "Shift-Enter". | Первый вариант: введите текст, создайте пустую строку, введите три тире (---), создайте пустую строку, введите текст.
Второй вариант: введите текст, перейдите на новую строку, введите тройное нижнее подчёркивание (___), перейдите на новую строку, введите текст.
|
| Таблица текста Заголовок1 Заголовок2 |
Заголовок1 | Заголовок2 |
Отлично подходит для автоматического выравнивания текста с заголовком.
|
| Текст ссылки | [Текст ссылки](URL_ссылки) Например: |
Обратите внимание, что между квадратными и круглыми скобками не должно быть пробела.
|
|
 | Альтернативный текст не отображается, но должен присутствовать. Вводите полный URL на ваше изображение (которое будет масштабировано) |
|
:smiley: | Шпаргалка по Emoji насчитывает сотни эмоций, но если код не работает, вы можете использовать свою таблицу символов (mac windows), чтобы вставить его |
Обход работы Markdown[]
Markdown может быть чрезвычайно полезным, но временами он может мешать. Следующая таблица содержит известные проблемы, с которыми игроки могут столкнуться и их решения:
| Вы получаете | Вы хотите | Решение | Примечания |
|---|---|---|---|
| 1. Пункт первый
1. Пункт второй 1. Пункт третий |
1. Пункт первый
2. Пункт второй 3. Пункт третий |
1\. Пункт первый
2\. Пункт второй 3\. Пункт третий |
Markdown интерпретирует строку, начинающуюся с цифры, за которой следует точка в качестве пронумерованного элемента списка. Если Markdown сбрасывает нумерацию, когда это не предполагается, то вставка обратного слэша между цифрой и точкой решает проблему. |
Особые возможности Markdown[]
В следующей таблице приведены некоторые ухищрения, которые можно использовать везде, где поддерживается Markdown
| Отображаемое | Код разметки | Примечания |
|---|---|---|
| 𝕱𝖆𝖓𝖈𝖞 𝖙𝖊𝖝𝖙 𝖋𝖔𝖓𝖙 | Используйте https://www.latestfancytext.xyz для генерации текста. Не латинские символы пока не поддерживаются | Существует несколько типов генерируемых фантазийных текстов, включая смайлики, включающие и перевернутый текст. Сгенерированный текст не будет доступен для поиска, поскольку он использует символы Юникода |
 |
 |
В задачах можно включить индикаторы хода выполнения, чтобы отображать относительный прогресс для каждого навыка, ежедневного дела или задачи (даже для каждого элемента контрольного списка) или вознаграждения, а также в остальной части Habitica, где поддерживается Markdown. На сайте можно найти больше примеров. |
Математические формулы и графики (LaTeX)
  Пример (нажмите чтобы увеличить) |
Замените 'URLграфика' ссылкой изображения, созданной следующим образом:
|
Используется стандартный синтаксис разметки изображении в Markdown для вставки математических формул и графики.
Альтернативный текст не отображается, но должен присутствовать. Вводите полный URL на ваше изображение (которое будет масштабировано) |
Карты (используется OSM)
  Пример (нажмите чтобы увеличить) |
Найдите нужную позицию на карте OpenStreetMap.org и замените координаты и масштаб в приведенном примере на свои. Для https://www.openstreetmap.org/#map=19/51.50131/-0.12029 здесь 19 - уровень масштабирования, а два других числа - координаты |
Используется карта OpenStreetMap и staticMapLite.
Если вы копируете координаты прямо из адресной строки, не забудьте заменить косую черту (/) между координатами запятой (,). Также обратите внимание на то, что, хотя более низкие уровни масштабирования работают, они могут не отображаться четко на Habitica. Параметр size задает ширину и высоту прямоугольника с центром в текущей позиции, который будет обрезаться для создания окончательного изображения. |
См. также[]
- Официальное руководство по Markdown (англ.)
- Что такое Markdown? (англ.)
- 10-минутный Markdown-учебник (англ.)