Markdown-редактор
Markdown-редактор - это стандартный редактор, который используется в системе. Облегчённый язык разметки, созданный с целью написания наиболее читаемого и удобного для правки текста, но пригодного для преобразования в языки для продвинутых публикаций (HTML, Rich Text и других).
Возможность использования в редакторе:
Шпаргалка по Markdown
(перевод, оригинал)
Поиграть с разметкой Markdown можно на демо-странице.
Содержание
Заголовки Выделение Списки Ссылки Изображения Подсветка кода и синтаксиса Таблицы Цитаты Встроенный HTML Горизонтальная линия Новая строка Видео Youtube
Заголовки
H1
H2
H3
H4
H5
H6
Кроме того, заголовки H1 и H2 можно обозначить подчеркиванием:
Alt-H1
Alt-H2
Выделение
Курсив обозначается звездочками или подчеркиванием.
Полужирный шрифт - двойными звездочками или подчеркиванием.
Комбинированное выделение звездочками и подчеркиванием.
Для зачеркнутого текста используются две тильды . Уберите это.
Списки
(В данном примере предшествующие и завершающие пробелы обозначены точками: ⋅)
Первый пункт нумерованного списка
Второй пункт
Ненумерованный вложенный список.
Сами числа не имеют значения, лишь бы это были цифры
Нумерованный вложенный список
И еще один пункт.
Внутри пунктов списка можно вставить абзацы с таким же отступом. Обратите внимание на пустую строку выше и на пробелы в начале (нужен по меньшей мере один, но здесь мы добавили три, чтобы также выровнять необработанный Markdown).
Чтобы вставить разрыв строки, но не начинать новый параграф, нужно добавить два пробела перед новой строкой. Эта текст начинается с новой строки, но находится в том же абзаце. (В некоторых обработчиках, например на Github, пробелы в начале новой строки не нужны.)
Ненумерованный список можно размечать звездочками
Или минусами
Или плюсами
Ссылки
Ссылки можно оформить разными способами.
Относительная ссылка на документ
Для ссылок со сноской можно использовать цифры
Или можно просто вставить ссылку в квадратные скобки текст ссылки
Произвольный текст, после которого можно привести ссылки.
(*) Для символов не входящих в ASCII, например кириллицы, текст сноски все-таки регистрозависим (прим. перев.)
Изображения
Вот наш логотип (наведите указатель, чтобы увидеть текст заголовка):
Код и подсветка синтаксиса
Блоки кода являются частью функций Markdown, но не подсветка синтаксиса. Однако многие обработчики, например Github или Markdown Here, поддерживают подсветку синтаксиса. Список поддерживаемых языков и способ их указания может различаться. Markdown Here поддерживает десятки языков (и не-языков, например синтаксис diff и заголовки HTTP); полный список и способ указания языков см. на странице highlight.js demo-странице.
Код
в строке обрамляется обратными апострофами
.
Блоки кода выделяются либо тремя обратными апострофами ```
либо четырьмя пробелами в каждой строке. Рекомендуется использовать три апострофа -- они проще и только они поддерживают подсветку синтаксиса.
Таблицы
Таблицы не являются частью Markdown, но многие обработчики, например Markdown Here и Github, поддерживают их. Они позволяют легко добавить таблицы в электронное письмо -- в других случаях для этого нужно копировать их из другого приложения.
Вертикальные линии обозначают столбцы.
Внешние вертикальные линии (|) не обязательны и нужны только, чтобы сам код Markdown выглядел красиво. Тот же код можно записать так:
Цитаты
С помощью цитат очень удобно в письме обозначать исходный текст. Эта строка - часть той же цитаты.
Разрыв цитаты.
Это очень длинная строка, но она будет правильно процитирована даже при размещении на нескольких строках. Продолжаем писать, чтобы эта строка не вмещалась на одной строке в любом окне. Кстати, в цитаты можно также размечать с помощью Markdown.
Встроенный HTML
Часто Markdown понимает чистый HTML.
Список определенийЭто то, что люди иногда используют.Markdown внутри HTMLРаботает *не очень** хорошо. Используйте HTML-теги.
Горизонтальные линии
Три и более...
Дефисы
Звездочки
Подчеркивания
Новая строка
Для понимания работы разрыва строка автор главным образом рекомендует экспериментировать и пробовать -- нажмите <Enter> один раз (т.е. перейдите на новую строку), потом нажмите дважды (т.е. вставьте две новые строки) и посмотрите что приозошло. Вы сразу поймете что вам нужно. В расширении Markdown Here для браузеров есть удобная функция "Markdown Toggle", которая поможет в этом.
Примечание переводчика: Для переноса на новую строку в конце предыдущей строки необходимо добавить два пробела. Без этого большинство парсеров Markdown не выполняют переход на новую строку.
Попробуйте ввести следующее:
Это начальная строка
Эта строка отделена от предыдущей двумя новыми строками и станет отдельным абзацем.
Это тоже отдельный абзац, но...[здесь два пробела]
Эта строка отделена одной новой строкой, поэтому она находится в том же абзаце.
(Примечание: В Markdown Here разрывы строк ведут себя так же, как в GFM, поэтому не нужно вставлять по две новые строки.)
Видео Youtube
Ролики нельзя вставить напрямую, но можно вставить изображение со ссылкой на видео, например:
На чистом Markdown, но без размеров изображения и рамки:
Last updated