mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2025-04-26 23:23:55 +00: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
|
lang: ru-ru
|
||||||
---
|
---
|
||||||
|
|
||||||
Язык разметки Markdown создан Джоном Грубером (англ. John Gruber) и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году. Авторы задавались целью создать максимально удобочитаемый и удобный в публикации облегчённый язык разметки, пригодный для последующего преобразования в HTML (а также и в другие форматы).
|
Язык разметки Markdown создан Джоном Грубером (англ. John Gruber)
|
||||||
|
и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году.
|
||||||
|
Авторы задавались целью создать максимально удобочитаемый
|
||||||
|
и удобный в публикации облегчённый язык разметки,
|
||||||
|
пригодный для последующего преобразования в HTML
|
||||||
|
(а также и в другие форматы).
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
<!-- Markdown является надмножеством HTML, поэтому любой HTML-файл является
|
<!-- Markdown является надмножеством HTML, поэтому любой HTML-файл является
|
||||||
валидным документом Markdown, что позволяет использовать напрямую любые элементы
|
валидным документом Markdown, что позволяет использовать напрямую
|
||||||
HTML-разметки, такие, например, как этот комментарии.
|
любые элементы HTML-разметки, такие, например, как этот комментарий.
|
||||||
Встроенные в документ HTML-элементы не затрагиваются парсером Markdown
|
Встроенные в документ HTML-элементы не затрагиваются парсером Markdown
|
||||||
и попадают в итоговый HTML без изменений. Однако, следует понимать,
|
и попадают в итоговый HTML без изменений. Однако, следует понимать,
|
||||||
что эта жа особенность не позволяет использовать разметку Markdown внутри
|
что эта же особенность не позволяет использовать разметку Markdown внутри
|
||||||
HTML-элементов -->
|
HTML-элементов -->
|
||||||
|
|
||||||
<!-- Ещё одна особенность формата Markdown состоит в том, что поддерживаемые
|
<!-- Ещё одна особенность формата Markdown состоит в том, что поддерживаемые
|
||||||
возможности разметки зависят от конкретной реализации парсера. В данном
|
возможности разметки зависят от конкретной реализации парсера. В данном
|
||||||
руководстве возможности, поддерживаемые лишь определёнными парсерами
|
руководстве возможности, поддерживаемые лишь определёнными парсерами,
|
||||||
сопровождаются соответствующими примечаниями. -->
|
сопровождаются соответствующими примечаниями. -->
|
||||||
|
|
||||||
<!-- Заголовки -->
|
<!-- Заголовки -->
|
||||||
|
|
||||||
<!-- HTML-элементы от <h1> до <h6> размечаются очень просто:
|
<!-- HTML-элементы от <h1> до <h6> размечаются очень просто:
|
||||||
текст, который должен стать заголовком, предваряется соответствующим количеством
|
текст, который должен стать заголовком, предваряется
|
||||||
символов "#": -->
|
соответствующим количеством символов "#": -->
|
||||||
# Это заголовок h1
|
# Это заголовок h1
|
||||||
## Это заголовок h2
|
## Это заголовок h2
|
||||||
### Это заголовок h3
|
### Это заголовок h3
|
||||||
@ -47,7 +52,7 @@ HTML-элементов -->
|
|||||||
<!-- Текст легко сделать полужирным и/или курсивным: -->
|
<!-- Текст легко сделать полужирным и/или курсивным: -->
|
||||||
|
|
||||||
*Этот текст будет выведен курсивом.*
|
*Этот текст будет выведен курсивом.*
|
||||||
_Также как этот._
|
_Так же, как этот._
|
||||||
|
|
||||||
**А этот текст будет полужирным.**
|
**А этот текст будет полужирным.**
|
||||||
__И этот тоже.__
|
__И этот тоже.__
|
||||||
@ -56,15 +61,15 @@ __И этот тоже.__
|
|||||||
**_И тут!_**
|
**_И тут!_**
|
||||||
*__И даже здесь!__*
|
*__И даже здесь!__*
|
||||||
|
|
||||||
<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github
|
<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github,
|
||||||
для рендеринга Markdown-документов) текст можно сделать зачёркнутым: -->
|
для рендеринга Markdown-документов) текст можно сделать зачёркнутым: -->
|
||||||
|
|
||||||
~~Зачёркнутый текст.~~
|
~~Зачёркнутый текст.~~
|
||||||
|
|
||||||
<!-- Параграфами являются любые строки, следующие друг за другом.
|
<!-- Абзацами являются любые строки, следующие друг за другом.
|
||||||
Разделяются же параграфы - одной или несколькими пустыми строками: -->
|
Разделяются же абзацы одной или несколькими пустыми строками: -->
|
||||||
|
|
||||||
Это параграф. Всё предельно просто.
|
Это абзац. Всё предельно просто.
|
||||||
|
|
||||||
А тут уже параграф №2.
|
А тут уже параграф №2.
|
||||||
Эта строка всё ещё относится к параграфу №2!
|
Эта строка всё ещё относится к параграфу №2!
|
||||||
@ -72,7 +77,7 @@ __И этот тоже.__
|
|||||||
|
|
||||||
О, а вот это уже параграф №3!
|
О, а вот это уже параграф №3!
|
||||||
|
|
||||||
<!-- Для втавки принудительных переносов можно использовать HTML-тэг <br/>: -->
|
<!-- Для вставки принудительных переносов можно использовать HTML-тэг <br/>: -->
|
||||||
|
|
||||||
Принудительный <br/> перенос!
|
Принудительный <br/> перенос!
|
||||||
|
|
||||||
@ -90,24 +95,24 @@ __И этот тоже.__
|
|||||||
|
|
||||||
<!-- Списки -->
|
<!-- Списки -->
|
||||||
<!-- Маркированные списки размечаются вставкой в начало каждого элемента
|
<!-- Маркированные списки размечаются вставкой в начало каждого элемента
|
||||||
одного из символов "*", "+" и "-":
|
одного из символов "*", "+" или "-":
|
||||||
(символ должен быть одним и тем же для всех элементов) -->
|
(символ должен быть одним и тем же для всех элементов) -->
|
||||||
|
|
||||||
* Список,
|
* Список,
|
||||||
* Размеченный
|
* Размеченный
|
||||||
* "Звёздочками"
|
* Звёздочками
|
||||||
|
|
||||||
либо
|
либо
|
||||||
|
|
||||||
+ Список,
|
+ Список,
|
||||||
+ Размеченный
|
+ Размеченный
|
||||||
+ "Плюсами"
|
+ Плюсами
|
||||||
|
|
||||||
либо
|
либо
|
||||||
|
|
||||||
- Список,
|
- Список,
|
||||||
- Размеченный
|
- Размеченный
|
||||||
- "Дефисами"
|
- Дефисами
|
||||||
|
|
||||||
<!-- В нумерованных списках каждая строка начинается
|
<!-- В нумерованных списках каждая строка начинается
|
||||||
с числа и точки вслед за ним: -->
|
с числа и точки вслед за ним: -->
|
||||||
@ -155,7 +160,7 @@ __И этот тоже.__
|
|||||||
<!-- Github Flavored Markdown позволяет указать для блока кода синтаксис оного.
|
<!-- Github Flavored Markdown позволяет указать для блока кода синтаксис оного.
|
||||||
В этом случае синтаксис внутри блока будет подсвечен. Пример: -->
|
В этом случае синтаксис внутри блока будет подсвечен. Пример: -->
|
||||||
|
|
||||||
\`\`\`ruby <!-- Только нужно будет убрать backslashes, оставив лишь "```ruby" -->
|
\`\`\`ruby <!-- Только нужно будет убрать символы "\", оставив лишь "```ruby" -->
|
||||||
def foobar
|
def foobar
|
||||||
puts "Hello world!"
|
puts "Hello world!"
|
||||||
end
|
end
|
||||||
@ -174,9 +179,10 @@ end
|
|||||||
****************
|
****************
|
||||||
|
|
||||||
<!-- Ссылки -->
|
<!-- Ссылки -->
|
||||||
<!-- Одной из сильных сторон Markdown можно смело считать то, как просто
|
<!-- Одной из сильных сторон Markdown можно смело считать то,
|
||||||
размечаются гипер-ссылки. Для создания ссылки укажите текст ссылки, заключив его в
|
как просто размечаются гиперссылки. Для создания ссылки укажите
|
||||||
квадратные скобки, и сразу после - url, заключенный в "круглые" -->
|
текст ссылки, заключив его в квадратные скобки,
|
||||||
|
и сразу после - url, заключенный в "круглые" -->
|
||||||
|
|
||||||
[Ссылка!](http://test.com/)
|
[Ссылка!](http://test.com/)
|
||||||
|
|
||||||
@ -193,15 +199,16 @@ end
|
|||||||
[Здесь][link1] высможете узнать больше!
|
[Здесь][link1] высможете узнать больше!
|
||||||
А можно кликнуть [сюда][foobar], если очень хочется.
|
А можно кликнуть [сюда][foobar], если очень хочется.
|
||||||
|
|
||||||
<!-- где нибудь внизу -->
|
<!-- где-нибудь внизу -->
|
||||||
[link1]: http://test.com/ "Круто!"
|
[link1]: http://test.com/ "Круто!"
|
||||||
[foobar]: http://foobar.biz/ "Тоже хорошо!"
|
[foobar]: http://foobar.biz/ "Тоже хорошо!"
|
||||||
|
|
||||||
<!-- Примечания:
|
<!-- Примечания:
|
||||||
- Подсказка может быть заключена в одинарные кавычки вместо двойных,
|
- Подсказка может быть заключена в одинарные кавычки вместо двойных,
|
||||||
а также - в круглые скобки.
|
а также в круглые скобки.
|
||||||
- Сноска может находиться в любом месте документа и может иметь ID
|
- Сноска может находиться в любом месте документа и может иметь
|
||||||
произвольной длины, лишь бы это ID был уникальным. -->
|
идентификатор (далее ID) произвольной длины,
|
||||||
|
лишь бы это ID был уникальным. -->
|
||||||
|
|
||||||
<!-- Также при разметке ссылок-сносок можно опустить ID,
|
<!-- Также при разметке ссылок-сносок можно опустить ID,
|
||||||
если текст ссылки уникален в пределах документа: -->
|
если текст ссылки уникален в пределах документа: -->
|
||||||
@ -227,20 +234,21 @@ end
|
|||||||
[myimage]: relative/urls/cool/image.jpg "подсказка"
|
[myimage]: relative/urls/cool/image.jpg "подсказка"
|
||||||
|
|
||||||
<!-- Ещё немного ссылок: -->
|
<!-- Ещё немного ссылок: -->
|
||||||
<!-- Авто-ссылки -->
|
<!-- Автоссылки -->
|
||||||
|
|
||||||
Ссылка вида <http://testwebsite.com/> эквивалентна
|
Ссылка вида <http://testwebsite.com/> эквивалентна
|
||||||
[http://testwebsite.com/](http://testwebsite.com/)
|
[http://testwebsite.com/](http://testwebsite.com/)
|
||||||
|
|
||||||
<!-- Авто-ссылки для email -->
|
<!-- Автоссылки для адресов электронной почты -->
|
||||||
|
|
||||||
<foo@bar.com>
|
<foo@bar.com>
|
||||||
|
|
||||||
<!-- Экранирование символов -->
|
<!-- Экранирование символов -->
|
||||||
|
|
||||||
<!-- Может потребоваться вставить спец-символ в текст "как есть",
|
<!-- Может потребоваться вставить спецсимвол в текст "как есть",
|
||||||
т.е. защитить его от обработки парсером.
|
т.е. защитить его от обработки парсером.
|
||||||
Такой символ должен быть "экранирован" с помощью обратного слэша: -->
|
Такой символ должен быть "экранирован" с помощью обратной косой черты
|
||||||
|
(символа "\"): -->
|
||||||
|
|
||||||
\*текст, заключённый в звёздочки!\*
|
\*текст, заключённый в звёздочки!\*
|
||||||
|
|
||||||
@ -249,7 +257,7 @@ end
|
|||||||
да и синтаксис имеют не слишком удобный.
|
да и синтаксис имеют не слишком удобный.
|
||||||
Но если очень нужно, размечайте таблицы так: -->
|
Но если очень нужно, размечайте таблицы так: -->
|
||||||
|
|
||||||
| Колонка 1 | Колонка 2 | Колонка 3 |
|
| Столбец 1 | Столбец 2 | Столбец 3 |
|
||||||
| :----------- | :----------: | -----------: |
|
| :----------- | :----------: | -----------: |
|
||||||
| Выравнивание | Выравнивание | Выравнивание |
|
| Выравнивание | Выравнивание | Выравнивание |
|
||||||
| влево | по центру | вправо |
|
| влево | по центру | вправо |
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user