Вы здесь

Информация по использованию Markdown

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

Синтаксис у Markdown очень простой и легко запоминается. Для тех кто не знаком, или "подзабыл" как им пользоваться, ниже вы сможете найти доступные выражения на данном сайте с примерами.

Заголовки

Вариант №1

Заголовок H1
=============
Заголовок H2
-------------

Вариант №2

В данном варианте заголовки обозначаются символом "хэштега". Количество хэштегов равняется номер заголовку. Соответственно, их количество должно быть от 1 до 6.

# Заголовок H1
## Заголовок H2
###### Заголовок H6

Для своего же удобства, вы можете "закрывать" хэштеги.
## Заголовок H2 ##

Цитирование

> Параграф номер один.

Списки

Для добавления маркированных списков используется один из следующих символов: *, + или -.

-  Первый элемент списка
-  Второй элемент списка
-  Третий элемент списка

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

1.  Пункт один
2.  Пункт два

Ссылки

Вариант №1

Это [пример](http://example.com/ "Заголовок") гиперссылки.

[Эта ссылка](http://example.net/) без заголовка.

Преобразуется в следующий HTML:

<p>Это <a href="http://example.com/" title="Заголовок">пример</a> гиперссылки.</p>

<p><a href="http://example.net/">Эта ссылка</a> без заголовка.</p>

Вариант №2

Второй вариант немного проще в редактировании, и использовании одинаковых ссылок.

На [своём сайте][1] я использую статистику [Google][2] и [Яндекс][3].
Статистика от [гугла][2] мне нравится больше.

[1]: http://example.com/
[2]: http://google.com/
[3]: http://yandex.ru/

Превратиться в следующий HTML:

<p>На <a href="http://example.com/">своём сайте</a> я использую статистику <a href="http://google.com/">Google</a> и <a href="http://yandex.ru/">Яндекс</a>.<br>
Статистика от <a href="http://google.com/">гугла</a> мне нравится больше.</p>

Вариант №3

<http://google.ru>

Превратиться в HTML

<a href="http://google.ru">http://google.ru</a>

Форматирование текста

*одинарные звездочки*
_одинарное нижнее подчеркивание_
**двойные звездочки**
__двойное нижнее подчеркивание__

Превратиться в следующий HTML

<em>одинарные звездочки</em>
<em>одинарное нижнее подчеркивание</em>
<strong>двойные звездочки</strong>
<strong>двойное нижнее подчеркивание</strong>

Код

Код из одной строки

`$varibale = 'value'`

Код из двух и более строк

В этом случае код сверху и снизу оборачивается тройной тильдой
~~~

Код с подсветкой синтаксиса

Для этого достаточно к тройной тильде дописать language-xxx где xxx — название языка разметки. Доступные варианты:

  • markup (html и прочее)
  • php
  • css
  • js
  • git
  • bash

Пример:
~~~php
В закрывающем теге этого указывать не нужно.

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

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

![Альтернативный текст](/path/to/img.jpg)
![Альтернативный текст](/path/to/img.jpg "Заголовок")
2
5
27.12.2014 - 17:05

Комментарии

Аватар пользователя SAM
SAM – 03.01.2015 - 09:18

Я бы всё же советовал прикрутить нормальный визуальный редактор и к нему плагин хайлайна.

Аватар пользователя Иван Гришаев
Иван Гришаев – 14.01.2015 - 14:58

я как фоннат маркдауна заявляю:
- тех, кто за визуальный редактор -- сжечь
- код можно обрамлять тройной одинарной кавычкой:

```

Аватар пользователя Samodelkin
Samodelkin – 15.03.2015 - 21:40

тест разметки

print 'test';
Аватар пользователя VVS
VVS – 26.05.2015 - 23:01

Я как граммар-наци, советую исправить "Превратиться" на "Превратится", см..
Или вообще убрать магию, и заменить на "Выглядит в HTML".

ГН