Пробный пост: повышаем культуру markdown

Это пробная статья, с помощью которой я хотел бы выяснить, имеется ли в Голосе необходимость повышения культуры оформления статей. Сегодня речь пойдёт о некоторых плохо известных большинству пользователей фишках markdown языка.

Создавая пост в Голосе, кто-то пользуется markdown разметкой, но я заметил, что не все пользуются её более богатыми возможностями. Опишу их, предполагая, что самые базовые основы разметки вы уже знаете. Прошу прощения, если кто-то об этом уже написал, я не нашёл. (UPD, позже выяснилось, что подробное руководство уже есть).

Не забудьте во время экспериментов переключиться в правильный режим редактирования.

Моноширинный текст

Делается с помощью обратных кавычек: `текст`, которые на большинстве клавиатур находятся там же где буква ё, но в английской раскладке. Получаем: текст.

Такой текст обычно используется для выделения кусочков кода в программировании, но здесь в Голосе он также выделяется цветом, а потому может служить способом обратить внимание на что-то, выделить какие-то численные показатели и т. д. Не злоупотребляйте.

Примеры

• Правильно: Как следует из формулы 2+2=4, данный интеграл по контуру из теоремы Коши... ;
• Правильно, но нежелательно: Исследование показало, что 90% людей считают, что они умнее 90% людей;
• Неправильно: Ты не можешь так говорить обо мне.

Код программы

Выделяется тремя обратными кавычками ``` вначале и тремя в конце. Вот так:

```
КОД
```

Примеры

// Подсчёт количества единичных битов в целом числе размером 64 бита без знака
int count_ones (unsigned long long a) {
  a -= (a>>1) & 0x5555555555555555ULL;
  a = ((a>>2) & 0x3333333333333333ULL) + (a & 0x3333333333333333ULL);
  a = ((((a>>4)+a) & 0x0F0F0F0F0F0F0F0FULL) * 0x0101010101010101ULL) >> 56;
  return (int)a;
}

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

Это код (перед этой строкой в редакторе я поставил 4 пробела).

Пользуйтесь этим способом только для выделения кода или какого-то алгоритма, а не для обычного текста. Читать моноширинный структурированный текст трудно.

Горизонтальная линия

Делается с новой строки через три тире подряд --- или тремя звёздочками подряд ***. Получается такая горизонтальная линия

---

Позволяет выделить некий участок текста или отделить одну часть статьи от другой Также может быть удобной для визуального отделения заголовка от текста (но не всегда это хорошо выглядит):

Заголовок

---

Некий текст.

Выделение управляющих символов

Вы спросите, а как можно напечатать обратную кавычку, если она воспринимается как начало моноширинного текста? Очень просто, поставьте перед ней символ обратной косой черты \. То есть для того, чтобы получить символ ` в статье, я был вынужден напечатать \`. А чтобы получить обратную косую черту \, мне потребовалось напечатать \\.

К сожалению, в Голосе (как я понял) поддерживаются не все фишки markdown, например, сноски [^1] или подсветка слов ==слово==. Но, возможно, всё это когда-нибудь появится¹.

Голосуйте, если подобный ликбез необходим в голосе.

---

1. Эта сноска была сделана искусственно с помощью верхнего индекса <sup>1</sup> и ручной постановкой номера 1. слева в этом абзаце.