diff options
| -rw-r--r-- | ru-ru/markdown-ru.html.markdown | 68 |
1 files changed, 38 insertions, 30 deletions
diff --git a/ru-ru/markdown-ru.html.markdown b/ru-ru/markdown-ru.html.markdown index 8b2a0982..eb8e4881 100644 --- a/ru-ru/markdown-ru.html.markdown +++ b/ru-ru/markdown-ru.html.markdown @@ -7,27 +7,32 @@ filename: markdown-ru.md lang: ru-ru --- -Язык разметки Markdown создан Джоном Грубером (англ. John Gruber) и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году. Авторы задавались целью создать максимально удобочитаемый и удобный в публикации облегчённый язык разметки, пригодный для последующего преобразования в HTML (а также и в другие форматы). +Язык разметки Markdown создан Джоном Грубером (англ. John Gruber) +и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году. +Авторы задавались целью создать максимально удобочитаемый +и удобный в публикации облегчённый язык разметки, +пригодный для последующего преобразования в HTML +(а также и в другие форматы). ```markdown <!-- Markdown является надмножеством HTML, поэтому любой HTML-файл является -валидным документом Markdown, что позволяет использовать напрямую любые элементы -HTML-разметки, такие, например, как этот комментарии. +валидным документом Markdown, что позволяет использовать напрямую +любые элементы HTML-разметки, такие, например, как этот комментарий. Встроенные в документ HTML-элементы не затрагиваются парсером Markdown и попадают в итоговый HTML без изменений. Однако, следует понимать, -что эта жа особенность не позволяет использовать разметку Markdown внутри +что эта же особенность не позволяет использовать разметку Markdown внутри HTML-элементов --> <!-- Ещё одна особенность формата Markdown состоит в том, что поддерживаемые возможности разметки зависят от конкретной реализации парсера. В данном -руководстве возможности, поддерживаемые лишь определёнными парсерами +руководстве возможности, поддерживаемые лишь определёнными парсерами, сопровождаются соответствующими примечаниями. --> <!-- Заголовки --> <!-- HTML-элементы от <h1> до <h6> размечаются очень просто: -текст, который должен стать заголовком, предваряется соответствующим количеством -символов "#": --> +текст, который должен стать заголовком, предваряется +соответствующим количеством символов "#": --> # Это заголовок h1 ## Это заголовок h2 ### Это заголовок h3 @@ -47,7 +52,7 @@ HTML-элементов --> <!-- Текст легко сделать полужирным и/или курсивным: --> *Этот текст будет выведен курсивом.* -_Также как этот._ +_Так же, как этот._ **А этот текст будет полужирным.** __И этот тоже.__ @@ -56,15 +61,15 @@ __И этот тоже.__ **_И тут!_** *__И даже здесь!__* -<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github +<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github, для рендеринга Markdown-документов) текст можно сделать зачёркнутым: --> ~~Зачёркнутый текст.~~ -<!-- Параграфами являются любые строки, следующие друг за другом. -Разделяются же параграфы - одной или несколькими пустыми строками: --> +<!-- Абзацами являются любые строки, следующие друг за другом. +Разделяются же абзацы одной или несколькими пустыми строками: --> -Это параграф. Всё предельно просто. +Это абзац. Всё предельно просто. А тут уже параграф №2. Эта строка всё ещё относится к параграфу №2! @@ -72,7 +77,7 @@ __И этот тоже.__ О, а вот это уже параграф №3! -<!-- Для втавки принудительных переносов можно использовать HTML-тэг <br/>: --> +<!-- Для вставки принудительных переносов можно использовать HTML-тэг <br/>: --> Принудительный <br/> перенос! @@ -90,24 +95,24 @@ __И этот тоже.__ <!-- Списки --> <!-- Маркированные списки размечаются вставкой в начало каждого элемента -одного из символов "*", "+" и "-": +одного из символов "*", "+" или "-": (символ должен быть одним и тем же для всех элементов) --> * Список, * Размеченный -* "Звёздочками" +* Звёздочками либо + Список, + Размеченный -+ "Плюсами" ++ Плюсами либо - Список, - Размеченный -- "Дефисами" +- Дефисами <!-- В нумерованных списках каждая строка начинается с числа и точки вслед за ним: --> @@ -155,7 +160,7 @@ __И этот тоже.__ <!-- Github Flavored Markdown позволяет указать для блока кода синтаксис оного. В этом случае синтаксис внутри блока будет подсвечен. Пример: --> -\`\`\`ruby <!-- Только нужно будет убрать backslashes, оставив лишь "```ruby" --> +\`\`\`ruby <!-- Только нужно будет убрать символы "\", оставив лишь "```ruby" --> def foobar puts "Hello world!" end @@ -174,9 +179,10 @@ end **************** <!-- Ссылки --> -<!-- Одной из сильных сторон Markdown можно смело считать то, как просто -размечаются гипер-ссылки. Для создания ссылки укажите текст ссылки, заключив его в -квадратные скобки, и сразу после - url, заключенный в "круглые" --> +<!-- Одной из сильных сторон Markdown можно смело считать то, +как просто размечаются гиперссылки. Для создания ссылки укажите +текст ссылки, заключив его в квадратные скобки, +и сразу после - url, заключенный в "круглые" --> [Ссылка!](http://test.com/) @@ -193,15 +199,16 @@ end [Здесь][link1] высможете узнать больше! А можно кликнуть [сюда][foobar], если очень хочется. -<!-- где нибудь внизу --> +<!-- где-нибудь внизу --> [link1]: http://test.com/ "Круто!" [foobar]: http://foobar.biz/ "Тоже хорошо!" <!-- Примечания: - Подсказка может быть заключена в одинарные кавычки вместо двойных, - а также - в круглые скобки. -- Сноска может находиться в любом месте документа и может иметь ID -произвольной длины, лишь бы это ID был уникальным. --> + а также в круглые скобки. +- Сноска может находиться в любом месте документа и может иметь +идентификатор (далее ID) произвольной длины, +лишь бы это ID был уникальным. --> <!-- Также при разметке ссылок-сносок можно опустить ID, если текст ссылки уникален в пределах документа: --> @@ -227,20 +234,21 @@ end [myimage]: relative/urls/cool/image.jpg "подсказка" <!-- Ещё немного ссылок: --> -<!-- Авто-ссылки --> +<!-- Автоссылки --> Ссылка вида <http://testwebsite.com/> эквивалентна [http://testwebsite.com/](http://testwebsite.com/) -<!-- Авто-ссылки для email --> +<!-- Автоссылки для адресов электронной почты --> <foo@bar.com> <!-- Экранирование символов --> -<!-- Может потребоваться вставить спец-символ в текст "как есть", +<!-- Может потребоваться вставить спецсимвол в текст "как есть", т.е. защитить его от обработки парсером. -Такой символ должен быть "экранирован" с помощью обратного слэша: --> +Такой символ должен быть "экранирован" с помощью обратной косой черты +(символа "\"): --> \*текст, заключённый в звёздочки!\* @@ -249,7 +257,7 @@ end да и синтаксис имеют не слишком удобный. Но если очень нужно, размечайте таблицы так: --> -| Колонка 1 | Колонка 2 | Колонка 3 | +| Столбец 1 | Столбец 2 | Столбец 3 | | :----------- | :----------: | -----------: | | Выравнивание | Выравнивание | Выравнивание | | влево | по центру | вправо | |