Клавиатура Stack Overflow Markdown онлайн: блоки кода без ошибок
На сайте в основном код, поэтому и эта страница в основном про блоки кода.
Предпросмотр
Предпросмотр примерный: он показывает смысл разметки, а не то, как её нарисует конкретное приложение. Шрифты, цвета и отступы везде свои, а часть возможностей зависит от версии.
0 симв.
Что пишет каждая кнопка
| Действие | Синтаксис | Примечание |
|---|---|---|
| B | **bold** |
Жирный |
| I | *italic* |
Курсив |
| S | ~~strikethrough~~ |
Зачёркнутый |
| Code | `code` |
Код в строке - для имени, а не для блока |
| Kbd | <kbd>Ctrl</kbd> |
Клавиша - выглядит как кнопка клавиатуры |
| Indent 4 | code |
Блок кода отступом - четыре пробела, классический способ Stack Overflow |
| Code block | ```
code
``` |
Блок кода (в тройных обратных кавычках) |
| Language | <!-- language: lang-js --> |
Задать подсветку синтаксиса для следующего блока |
| H2 | ## Heading |
Заголовок - в ответах начинают со второго уровня |
| H3 | ### Heading |
Подзаголовок |
| Quote | > quoted |
Процитировать вопрос или сообщение об ошибке |
| List | - item |
Маркированный список |
| 1. | 1. step |
Пронумерованные шаги |
| Link | [text](https://example.com) |
Ссылка |
| Tag | [tag:javascript] |
Ссылка на тег - синтаксис Stack Exchange |
| Escape | *not italic* |
Ставит обратную косую черту перед \ ` * _ и другими символами, чтобы они оставались видны как есть, а не превращались в разметку. Выделите текст или просто поставьте курсор на строку |
Телефон собирает файл приложения - поэтому это дольше обычной загрузки.
Ищите этот значок: Stack Overflow
Четыре пробела сразу на всех строках
Классический блок кода на Stack Overflow - это четыре пробела в начале каждой строки. Добавлять их руками к двадцати строкам никто не хочет, и код вставляют простым текстом, теряя отступы. Выделите фрагмент целиком, нажмите кнопку один раз, и каждая строка получит свои четыре пробела.
Как выложить код, чтобы его было удобно читать
Блок кода можно отметить отступом в четыре пробела или ограждением из трёх обратных кавычек. На сайте работают оба способа: отступ старше и его ставит кнопка редактора, а ограждение быстрее для вставленного фрагмента. Здесь есть оба.
Подсветку Stack Overflow угадывает по тегам вопроса и на коротких фрагментах часто ошибается. Подсказка языка, комментарий перед блоком, задаёт её явно, и код перестаёт выглядеть серым текстом.
Как пользоваться
- Вставьте код в поле. Как есть, вместе с отступами.
- Выделите его и нажмите кнопку отступа. Каждая выделенная строка получит четыре пробела, повторное нажатие их уберёт.
- Добавьте подсказку языка, если нужна подсветка. Она пишется отдельной строкой перед блоком: lang-js, lang-py, lang-sql.
Вопросы и ответы
Отступ или ограждение: что лучше?
Оба способа принимаются и выглядят одинаково. В комментариях не работает ни один: там есть только код в строке в обратных кавычках.
Почему код не подсвечивается?
Подсветка определяется по тегам вопроса, и догадка не сработала. Подсказка языка перед блоком задаёт язык явно.
Почему заголовки в ответе выглядят странно?
На странице уже есть H1, это заголовок вопроса. Ответы начинают со второго уровня, и кнопки здесь пишут именно его.
