Markdown
О Markdown
Markdown расширяет простой формат ввода текста, доступный в Moodle, позволяя вам легко добавлять акценты (жирный, курсивный), структуру (маркированные списки и заголовки) и ссылки (на изображения или другие веб-ресурсы).
Для ввода текста просто напечатайте в текстовой области или текстовом поле, нажимая клавишу ввода дважды в конце абзаца, чтобы оставить пустую строку между концом одного абзаца и началом следующего.
Использование Markdown
Чтобы использовать Markdown, вам нужно выбрать «Текстовая область обычного текста» в качестве текстового редактора.
- Из меню пользователя (в правом верхнем углу) выберите «Настройки».
- Нажмите «Настройки редактора».
- Выберите «Текстовая область обычного текста», затем нажмите «Сохранить изменения».
Для любой текстовой области вы сможете выбрать «Формат Markdown» из выпадающего меню под ней.
Акцентирование текста
Вы можете добавить три уровня акцента с помощью Markdown: курсивный текст, жирный текст или жирный и курсивный текст. Это достигается путём окружения текста, который вы хотите выделить, звёздочками, например:
*курсив*
**жирный**
***жирный курсив***
Акценты могут быть добавлены к отдельным словам, последовательности слов или даже частям слов:
a *single* word
***a sequence of words***
in**distinguish**able
Нижние подчёркивания (_) могут использоваться взаимозаменяемо со звёздочками для этой цели.
Заголовки
Markdown позволяет вам подразделять текст заголовками; доступно шесть различных уровней, хотя для обычного текста редко используется более трёх. Например, в тексте, который вы сейчас читаете, используются три уровня заголовков.
Вы можете создать заголовок, начав строку с одним или несколькими символами решётки (#). Одна решётка — это самый крупный и важный заголовок, а шесть решёток дают вам наименее важный или наименьший заголовок.
# заголовок раздела
## заголовок подсекции
### заголовок подраздела
и т. д.
Первые два уровня заголовков наиболее распространены и могут быть созданы альтернативными способами, которые делают их более заметными в текстовой версии (хотя вывод идентичен предыдущему методу). Этот альтернативный способ использует строку из знаков равенства (=) или дефисов (-) под заголовком следующим образом:
Заголовок раздела
===============
Подзаголовок
------------------
Списки
Чтобы список был распознан как список, перед всеми списками должна быть пустая строка. Без пустой строки текст не будет отображаться как список.
Маркированные списки
Маркированные списки можно создать, начав каждую строку со звёздочки, за которой следует пробел перед содержанием пункта списка. Обратите внимание, что пробел важен и его не следует забывать.
* первый пункт
* второй пункт
* третий пункт
Нумерованные списки
Аналогично, нумерованные списки можно создать, начав каждую строку с номера, за которым следует пробел, а затем соответствующий текст.
1. первый пункт
2. второй пункт
3. третий пункт
Вложенные списки
Вы можете вкладывать или отступать маркированные и нумерованные списки, даже смешивая маркированные и нумерованные списки в одной структуре:
* верхний уровень, пункт один
* вложенный пункт
* вложенный пункт 2
* верхний уровень, пункт два
1. нумерованный пункт один
1. вложенный нумерованный пункт
2. нумерованный пункт два
Цитируемые абзацы
Вы можете указать цитируемый фрагмент текста, начав каждую строку с углового скобка (>). Этот символ был выбран, так как многие почтовые программы используют его для обозначения цитируемых фрагментов. Вывод обычно отступает цитируемый фрагмент от обоих полей.
> Это цитируемый абзац > разделённый на две строки
Вы можете сэкономить время, используя один угловой скобка в начале первой строки абзаца
> это всё один единственный цитируемый
абзац, даже если он разделён
на несколько строк.
Веб-ссылки
Есть два способа создать ссылки на веб-ресурсы: первый — включить ссылку напрямую, поместив текст, на который вы хотите, чтобы читатели нажимали, в квадратные скобки, а URL страницы, на которую они будут перенаправлены сразу после этого, — в скобках без пробела или промежутка между двумя наборами скобок; вы также можете добавить необязательный заголовок для ссылки в кавычках после URL.
An [example link](http://example.com/ "Optional Title") in a sentence.
Заголовок, если он указан, отображается в «подсказке», которая появляется, когда пользователь наводит курсор на текст ссылки. Попробуйте это сделать со ссылкой, которая появляется выше.
Для более длинных ссылок вы можете избежать нарушения потока текста, используя стиль сноски, прикрепив короткое идентифицирующее имя к ссылке во втором наборе квадратных скобок (используя короткое пояснительное слово, фразу или просто число).
An [example link][ex] in a sentence.
Затем в любом месте документа, но предпочтительно либо сразу после абзаца со ссылкой, либо собрав все URL-адреса ссылок в нижней части документа, вы можете определить URL, связанный с идентификатором:
[ex]: http://example.com/ "Optional Title"
Вывод этого второго примера будет неотличим от первого. Это просто вопрос поддержания рабочего документа в порядке для облегчения дальнейшего редактирования (особенно если вы работаете с другими).
Последний ярлык, если вы хотите, чтобы ваш связанный текст был таким же, как URL, заключается в том, чтобы поместить URL в угловые скобки следующим образом:
<http://moodle.org/>
Изображения
Изображения включаются очень похожим образом на веб-ссылки, но им предшествует восклицательный знак. «Альтернативный текст» (alt означает альтернативный) предоставляется пользователям, которые не могут видеть изображение по различным причинам, поэтому текст должен иметь смысл без каких-либо визуальных подсказок. Это также послужит напоминанием или подсказкой для тех, кто редактирует текст в Markdown относительно назначения изображения.
«Заголовок» отображается во всплывающем окне, когда пользователь наводит курсор на изображение, и может предоставить дополнительную информацию.
И, как и в случае с веб-ссылками, вы можете упорядочить свой документ, сохранив все URL-адреса вместе со ссылками в стиле «сноски». Просто дайте изображению короткое уникальное имя:
![alt text][photo]
и в любом другом месте вашего документа свяжите это имя с файлом изображения:
[photo]: /url/to/img.jpg "Optional Title"
Вот пример:
«Альтернативны й текст», который также важен по соображениям доступности, часто используется браузерами, когда ссылки на изображения повреждены или временно недоступны:
