Однострочный разделитель

Добавьте одну строку разметки к документу с помощью однострочного разделителя. Многократные непрерывные строки разделителей обрабатываются как единственный богатый комментарий. Должно быть точно одно пространство между однострочным разделителем и первым символом текста.

//: <valid marked up text>

Пример

//: This is a line of text that will appear as a rich comment in a playground.

//: These two lines of single delimiter text

//: show up as one rich comment block in the playground

Заголовки

Используйте знак номера (#) указать до трех уровней заголовка. Должно быть по крайней мере одно пространство между знаком номера и строкой заголовка.

Альтернатива

Подчеркните возглавляющую строку для уровня один и два заголовка. Число символов в заголовке и в строке подчеркивания должно быть тем же.

Примеры

Создайте уровень два заголовка с помощью знака номера.

//: ## This is a Heading 2

Создайте уровень, один заголовок с помощью равняется знаку. Обратите внимание на то, что число знаков «равно» совпадает с числом символов в возглавляющей строке.

//: This is a Heading 1

//: ===================

Списки

Добавьте маркируемые и пронумерованные списки с помощью языка разметки детской площадки.

Маркированные списки

Используйте звездочку (*) для каждого маркированного элемента. Должно быть точно одно пространство между звездочкой и строкой элемента.

* <string>

Пример

/*: A bulleted list of 2 items

* Item 1

* Item 2

*/

Пронумерованные списки

Каждый элемент в пронумерованном списке запускается с одних или более пробелов, целое число, сопровождаемое периодом (.), и затем требуемый текст. Должно быть точно одно пространство между периодом и строкой элемента.

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

Целое число, используемое на первой строке уровня списка, используется в качестве начального значения индекса в представлении обогащенного текста.

Пронумерованный уровень 1 списка	<integer>. <string>
Пронумерованный уровень 2 списка	<integer>. <string> 4 пробелов
Пронумерованный уровень 3 списка	<integer>. <string> 8 пробелов

Примеры

/*: A numbered list with 2 levels

1. Cat

2. Dog

1. Golden Retriever

3. Llama

*/

/*: Start the numbering of the rich text list at "4"

4. Fish

5. Lizard

*/

Второй пример выше запусков нумерация списка в 4 как показано:

Блок цитирования

Запустите каждую строку блока цитирования с большим - чем знак ([>]). Должно быть точно одно пространство между большим - чем знак и строкой элемента.

> <string>

Пример

/*: A block quote of the first four lines from a great prologue

> Oh for a Muse of fire, that would ascend

> The brightest heaven of invention,

> A kingdom for a stage, princes to act

> And monarchs to behold the swelling scene!

*/

Блок кода

Запустите каждую строку блока кода по крайней мере с четырьмя пробелами.

<string>

Пример

/*: How not to write a loop in Swift

    while true {

        println("When will this stop?")

    }

*/

Акцент

Добавьте акцент при помощи звездочки (*) или подчеркивание (_) в запуске и конце строки. Не смешивайте звездочки и подчеркивания для того же элемента.

*<string>*

Альтернатива

_<string>_

Пример

//: This line has a word with *emphasis*

//: This line uses _emphasis for the last six words_

Сильный

Добавьте сильное форматирование с двумя звездочками (**) или два подчеркивания (__) в запуске и конце строки. Не смешивайте звездочки и подчеркивания для того же элемента.

**<string>**

Альтернатива

__<string>__

Пример

//: A **strong * (asterisk)** is on this line

//: __A strong line__

Код

Текст формата как код при помощи обратной галочки (`) вначале и конец строки.

`<string>`

Пример

//: Show Swift elements such as `for` and `let` as monspaced code font

Изображение

Включайте изображения от сети или из Вашего проекта детской площадки.

![<alt text>](<URL> "<image title for hover>")

Примеры

Ссылка к изображению в сети с текстом парения.

//: ![Icon for a playground](http://devimages.apple.com.edgekey.net/swift/images/playgrounds.png "An image I seesawed")

Ссылка к ресурсу детской площадки без текста парения.

//: ![Anyone for tennis?](tennis.jpg)

Ссылка

Включайте ссылки к веб-ресурсам.

[<text to display>](<http URL>)

Пример

/*: Include a link to the Swift page in the text

See more about Swift by [following this link.](http://developer.apple.com/swift/)

*/

Горизонтальное правило

Используйте четыре или больше дефиса (-) окруженный пустыми строками для добавления горизонтального правила.

<blank line>

----

<blank line>

Пример

/*: A block of markup code showing a single horizontal line

----

*/

Escape наклонной черты влево

Выведите на экран специальные символы путем выхода из них с наклонной чертой влево (\). Необходимо использовать наклонную черту влево для отображения специального символа в следующих случаях.

• Разделитель является первым специальным символом строки разметки.

• Разделитель является первым специальным символом блочного элемента.

  Период является специальным символом для пронумерованного списка.

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

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

Для списка специальных символов посмотрите Символы Синтаксиса Комментария

\<special character>

Пример

//: Show the *middle asterisk\* with emphasis*