Umbraco 7 Markdown Помощь для клиентов

Синтаксис Markdown

Евгений Бощенко,
Евгений Бощенко Технический Директор Webevolution

Евгений Бощенко

Технология WYSIWYG широко распространена и давно всем известна. Но за простотой использования редактирования текстов в режиме WYSIWYG скрывается проблема — на выходе получается “мусорный” HTML-код, каким бы интеллектуальным не был WYSIWYG-редактор. Именно поэтому мы в свое время отказались от использования технологий WYSIWYG в пользу разметки с помощью Markdown.

Использование же Markdown позволяет добиться отличного, чистого и пригодного для SEO текста. Кроме того, синтаксис markdown позволяет свободно использовать html-тэги.

В данном руководстве для наглядности некоторые специальные символы, такие как пробел и переход на новую строку, будут выделены обозначениями и цветом.

Пробел — · (средняя точка)

Переход на следующую строку — ¶

Базовые элементы

Параграфы, заголовки и цитаты

Параграф выглядит как непрерывный текстом. Новый параграф обозначается разрывом чистой строкой, например:

Такой код создает на выходе следующие 2 параграфа, представленные на иллюстрации ниже. Несмотря на переносы в первых строках, новый параграф создает только пустая строка:

Чтобы принудительно вставить перенос строки, не создавая при этом параграф (тэг
в html) используют двойной пробел в конце строки:

Так мы получим также 2 параграфа, но с таким набором переносов:

Блок «Цитата»

Для создания блока цитаты, просто используйте символ > в начале строки:

Обратите внимание, данный фрагмент использует html-элемент для указания автора цитаты, так как markdown не имеет конструкции для обозначения авторства цитаты.

Заголовки

Для заголовков имеется 2 синтаксиса:

Альтернативный синтаксис для заголовков первого и второго уровня:

Достаточно одного символа = или -, но можно использовать большее количество для повышения читабельности.

Акценты

Для жирного шрифта окружите выделяемый текст двумя символами звездочки **

Что мы получим:

Для подчеркивания окружите выделяемый текст двумя символами подчеркивания __

Результат:

Списки

Список должен быть отделен от основного текста пустыми строками. Элемент списка начинается с символа пробела, затем идет символ элемента списка:

символ * (звездочка), - (минус) или + (плюс) — для маркированного списка; цифра с последующей точкой — для упорядоченного списка.

Обратите внимание что символ начала элемента списка обрамляется пробелом с обеих сторон.

Вставка изображений

Для вставки изображения в текст, используйте следующую конструкцию:

Где текст в первых квадратных скобках — текстовое описание изображение, которое будет помещено в атрибут alt-тэга img. Во вторых квадратных скобках указывается псевдоним изображения, он может быть числом или коротким текстовым описанием.

В конце разметки помещается список используемых псевдонимов с указанием url на изображение.

Вставка ссылок

Существует два метода вставки ссылок. Первый метод аналогичен вставки изображений, в тексте вводится имя ссылки с псевдонимом например ([Текст ссылки][1]), а в конце разметки вводится список псевдонимов с указанием url целевых страниц.

Второй метод позволяет вставить ссылку одной строкой:

Другие статьи по тегам

Umbraco CMS

на эту тему

Umbraco CMS
Руководство по Umbraco 7
- введение
Введение
Преимущества CMS Umbraco
Руководство по Umbraco 7
- начало работы
Что такое прототип
и прототипирование сайта
Зачем нужно проектирование сайта