mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-11-26 20:34:32 +03:00
edits of ru-ru/markdown-ru
This commit is contained in:
Aleksey Pirogov
parent
16b1249444
commit
9a2123c675
@ -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 |
|
||||
| :----------- | :----------: | -----------: |
|
||||
| Выравнивание | Выравнивание | Выравнивание |
|
||||
| влево | по центру | вправо |
|
||||
|
||||
Loading…
Reference in New Issue
Block a user