Пробный пост: повышаем культуру 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] или подсветка слов ==слово==. Но, возможно, всё это когда-нибудь появится¹.

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

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