Разметка сообщений (Markdown)
Мы используем популярную разметку Markdown с некоторыми дополнениями.
Параграфы
Параграфы текста разделяются пустой строкой. Единичные переводы строк в тексте игнорируются.
Перевод строки в середине параграфа возможен, для этого нужно оставить в конце строки перед переносом два пробела.
Кавычки, тире и другие символы
Кавычки автоматически заменяются на «лапки» ("текст"
превращается в «текст»).
Другие автозамены:
...
и. . .
заменяется на …--
на – (n-dash)---
на — (m-dash)
Заголовки
В заглавных сообщениях топиков поддерживается 6 уровней заголовков
# Заголовок 1
## Заголовок 2
### Заголовок 3
#### Заголовок 4
##### Заголовок 5
###### Заголовок 6
В комментариях поддерживается только один первый уровень заголовков.
Стили текста
*Курсив*
и_Курсив_
даёт курсив**Жирное начертание**
и__Жирное начертание__
даёт жирное начертание~~Зачеркнутый текст~~
даётзачеркнутый текст***Жирный курсив***
даёт Жирный курсив~~***Жирный зачёркнутый курсив***~~
даётЖирный зачёркнутый курсив
Преформатированный моноширинный текст
4 пробела перед началом абзаца начинают строку преформатированного моноширинного текста. Пример:
1 строка
2 строка
3 333333
4 строка конец
Даёт:
1 строка
2 строка
3 333333
4 строка конец
Ссылки
Ссылки выделяются автоматически. Ссылки на топики сайта автоматически отображаются с заголовком топика.
При необходимости можно указать заголовок ссылки следующим образом:
[GitHub](http://github.com)
Цитаты
Цитата выделяется символом >
в начале строки.
>>вложенная
>
>цитата
даёт:
вложенная
цитата
Если сделать так:
>>вложенная
>цитата
то получится это:
вложенная цитата
Упоминание пользователя сайта
@maxcom
даёт ссылку на профиль пользователя сайта. При использовании этого тега упомянутому пользователю приходит
уведомление.
Списки
Списки могут быть выделены при помощи знака *
или цифр с точкой(1.
). В зависимости от выбранного способа, получится нумерованный или наоборот, не нумерованный список. Изменить нумерацию нельзя.
Примеры:
* Item 1
* Item 2
* Item 3
* Item 4
даёт:
- Item 1
- Item 2
- Item 3
- Item 4
1. Item 1
2. Item 2
3. Item 3
4. Item 4
даёт:
- Item 1
- Item 2
- Item 3
- Item 4
А вот такая разметка:
1. Item 1
6. Item 6
13. Item 13
42. Item 42
даст неожиданный результат:
- Item 1
- Item 6
- Item 13
- Item 42
Вложенные списки
Вложенные списки создаются при помощи отступа в 4 пробела. Тип вложенного списка может отличаться от списка верхнего уровня. Пример:
1. 1 Пункт
2. А тут вложенность:
1. 1 вложенный пункт
2. 2 вложенный пункт
* а тут ещё больше вложенности!
* тут то же самое
3. Снова первый уровень
даёт:
- 1 Пункт
- А тут вложенность:
- 1 вложенный пункт
- 2 вложенный пункт
- а тут ещё больше вложенности!
- тут то же самое
- Снова первый уровень
Код и спецсимволы
Небольшой фрагмент кода можно выделить в параграфе апострофами. Например:
Попробуйте запустить команду `ls -lR`.
Блоки кода выделяются тремя апострофами:
```
git pull && sbt compile
```
Для разметки синтаксиса нужно указать используемый язык программирования:
```bash
git pull && sbt compile
```
Поддерживаются следующие языки:
- ABNF
- ASM-ARM
- ASM-AVR
- ASM-MIPS
- ASM-X86 (
asm
) - AWK
- Bash, Shell
- Basic (
bas
) - BNF
- Brainfuck
- C
- C# (
c#
,cs
) - C++ (
c++
,cpp
,cxx
,cc
) - Clojure
- CMake
- CoffeeScript
- CSS
- D
- Diff (
patch
,diff
) - EBNF
- Erlang
- F# (
f#
,fs
) - Fortran
- Go
- Haskell
- HTML, XML
- Ini
- Java
- JavaScript (
js
,javascript
) - JSON
- Julia (
jl
) - Lisp
- LLVM
- Lua
- Makefile
- Markdown (
md
) - Nim
- Nix
- OCaml
- Objective C (
objc
,objectivec
) - Pascal, Delphi (
pas
) - Perl
- PHP
- Python (
py
) - Ruby (
rb
) - Rust (
rs
) - Scala
- Scheme
- Smalltalk
- SQL
- TCL
- TypeScript (
ts
) - TeX
- Vala
- Vim
- WASM
- YAML
Спойлер (cut) в ленте
Длинные тексты в новостях и галерее можно скрыть при помощи следующей разметки:
Основной текст
>>>
Скрытый текст
<<<
Продолжение основного текста
В комментариях и сообщениях форума эта разметка игнорируется.
Таблицы
Таблицы можно собрать при помощи |
. Например:
| Heading Centered | Heading Left Aligned | Heading Centered | Heading Right Aligned |
|------------------------|:-----------------------|:------------------:|------------------------:|
| Cell text left aligned | Cell text left aligned | Cell text centered | Cell text right aligned |
| cell 21 | cell 22 | cell 22 | cell 22 |
Даёт
Heading Centered | Heading Left Aligned | Heading Centered | Heading Right Aligned |
---|---|---|---|
Cell text left aligned | Cell text left aligned | Cell text centered | Cell text right aligned |
cell 21 | cell 22 | cell 22 | cell 22 |