Нравится 0
Создать форк 0

Последняя активность 1751893489

imxored ревизий этого фрагмента 1751893489. К ревизии

1 file changed, 0 insertions, 0 deletions

gistfile1.txt переименован в gistfile1.md

Файл переименован без изменений

imxored ревизий этого фрагмента 1751893468. К ревизии

1 file changed, 379 insertions

gistfile1.txt(файл создан)

@@ -0,0 +1,379 @@
1 + Шпаргалка по Markdown
2 + ---------------------
3 + ([https://github.com/sandino/Markdown-Cheatsheet](https://github.com/sandino/Markdown-Cheatsheet))
4 + (перевод, [оригинал](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet))
5 +
6 + Поиграть с разметкой Markdown можно на [демо-странице](http://www.markdown-here.com/livedemo.html).
7 +
8 + ##### Содержание
9 + [Заголовки](#headers)
10 + [Выделение](#emphasis)
11 + [Списки](#lists)
12 + [Ссылки](#links)
13 + [Изображения](#images)
14 + [Подсветка кода и синтаксиса](#code)
15 + [Таблицы](#tables)
16 + [Цитаты](#blockquotes)
17 + [Встроенный HTML](#html)
18 + [Горизонтальная линия](#hr)
19 + [Новая строка](#lines)
20 + [Видео Youtube](#videos)
21 +
22 + <a name="headers"><h2>Заголовки</h2></a>
23 +
24 + ```no-highlight
25 + # H1
26 + ## H2
27 + ### H3
28 + #### H4
29 + ##### H5
30 + ###### H6
31 +
32 + Кроме того, H1 и H2 можно обозначить подчеркиванием:
33 +
34 + Alt-H1
35 + ======
36 +
37 + Alt-H2
38 + ------
39 + ```
40 +
41 + # H1
42 + ## H2
43 + ### H3
44 + #### H4
45 + ##### H5
46 + ###### H6
47 +
48 + Кроме того, заголовки H1 и H2 можно обозначить подчеркиванием:
49 +
50 + Alt-H1
51 + ======
52 +
53 + Alt-H2
54 + ------
55 +
56 + <a name="emphasis"><h2>Выделение</h2></a>
57 +
58 + ```no-highlight
59 + Курсив обозначается *звездочками* или _подчеркиванием_.
60 +
61 + Полужирный шрифт - двойными **звездочками** или __подчеркиванием__.
62 +
63 + Комбинированное выделение **звездочками и _подчеркиванием_**.
64 +
65 + Для зачеркнутого текста используются две тильды . ~~Уберите это.~~
66 + ```
67 +
68 + Курсив обозначается *звездочками* или _подчеркиванием_.
69 +
70 + Полужирный шрифт - двойными **звездочками** или __подчеркиванием__.
71 +
72 + Комбинированное выделение **звездочками и _подчеркиванием_**.
73 +
74 + Для зачеркнутого текста используются две тильды . ~~Уберите это.~~
75 +
76 +
77 + <a name="lists"><h2>Списки</h2></a>
78 +
79 + (В данном примере предшествующие и завершающие пробелы обозначены точками: ⋅)
80 +
81 + ```no-highlight
82 + 1. Первый пункт нумерованного списка
83 + 2. Второй пункт
84 + ⋅⋅*Ненумерованный вложенный список.
85 + 1. Сами числа не имеют значения, лишь бы это были цифры
86 + ⋅⋅1. Нумерованный вложенный список
87 + 4. И еще один пункт.
88 +
89 + ⋅⋅⋅Внутри пунктов списка можно вставить абзацы с таким же отступом. Обратите внимание на пустую строку выше и на пробелы в начале (нужен по меньшей мере один, но здесь мы добавили три, чтобы также выровнять необработанный Markdown).
90 +
91 + ⋅⋅⋅Чтобы вставить разрыв строки, но не начинать новый параграф, нужно добавить два пробела перед новой строкой.⋅⋅
92 + ⋅⋅⋅Этот текст начинается с новой строки, но находится в том же абзаце.⋅⋅
93 + ⋅⋅⋅(В некоторых обработчиках, например на Github, пробелы в начале новой строки не нужны.)
94 +
95 + * Ненумерованный список можно размечать звездочками
96 + - Или минусами
97 + + Или плюсами
98 + ```
99 +
100 + 1. Первый пункт нумерованного списка
101 + 2. Второй пункт
102 + * Ненумерованный вложенный список.
103 + 1. Сами числа не имеют значения, лишь бы это были цифры
104 + 1. Нумерованный вложенный список
105 + 4. И еще один пункт.
106 +
107 + Внутри пунктов списка можно вставить абзацы с таким же отступом. Обратите внимание на пустую строку выше и на пробелы в начале (нужен по меньшей мере один, но здесь мы добавили три, чтобы также выровнять необработанный Markdown).
108 +
109 + Чтобы вставить разрыв строки, но не начинать новый параграф, нужно добавить два пробела перед новой строкой.
110 + Эта текст начинается с новой строки, но находится в том же абзаце.
111 + (В некоторых обработчиках, например на Github, пробелы в начале новой строки не нужны.)
112 +
113 + * Ненумерованный список можно размечать звездочками
114 + - Или минусами
115 + + Или плюсами
116 +
117 + <a name="links"><h2>Ссылки</h2></a>
118 +
119 + Ссылки можно оформить разными способами.
120 +
121 + ```no-highlight
122 + [Обычная ссылка в строке](https://www.google.com)
123 +
124 + [Обычная ссылка с title](https://www.google.com "Сайт Google")
125 +
126 + [Ссылка со сноской][Произвольный регистронезависимый текст]
127 +
128 + [Относительная ссылка на документ](../blob/master/LICENSE)
129 +
130 + [Для ссылок со сноской можно использовать цифры][1]
131 +
132 + Или можно просто вставить ссылку в квадратные скобки [текст ссылки]
133 +
134 + Произвольный текст, после которого можно привести ссылки.
135 +
136 + [произвольный регистронезависимый текст]: https://www.mozilla.org
137 + [1]: http://slashdot.org
138 + [текст ссылки]: http://www.reddit.com
139 + ```
140 +
141 + [Обычная ссылка в строке](https://www.google.com)
142 +
143 + [Обычная ссылка с title](https://www.google.com "Сайт Google")
144 +
145 + [Ссылка со сноской][Произвольный регистронезависимый текст] *
146 +
147 + [Относительная ссылка на документ](../blob/master/LICENSE)
148 +
149 + [Для ссылок со сноской можно использовать цифры][1]
150 +
151 + Или можно просто вставить ссылку в квадратные скобки [текст ссылки]
152 +
153 + Произвольный текст, после которого можно привести ссылки.
154 +
155 + [Произвольный регистронезависимый текст]: https://www.mozilla.org
156 + [1]: http://slashdot.org
157 + [текст ссылки]: http://www.reddit.com
158 +
159 + (*) Для символов не входящих в ASCII, например кириллицы, текст сноски все-таки регистрозависим (прим. перев.)
160 +
161 + <a name="images"><h2>Изображения</h2></a>
162 +
163 + ```no-highlight
164 + Вот наш логотип (наведите указатель, чтобы увидеть текст заголовка):
165 +
166 + Внутри строки:
167 + ![alt-текст](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 1")
168 +
169 + В сноске:
170 + ![alt-текст][logo]
171 +
172 + [logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 2"
173 + ```
174 +
175 + Вот наш логотип (наведите указатель, чтобы увидеть текст заголовка):
176 +
177 + Внутри строки:
178 + ![alt-текст](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 1")
179 +
180 + В сноске:
181 + ![alt-текст][logo]
182 +
183 + [logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Текст заголовка логотипа 2"
184 +
185 + <a name="code"><h2>Код и подсветка синтаксиса</h2></a>
186 +
187 + Блоки кода являются частью функций Markdown, но не подсветка синтаксиса. Однако многие обработчики, например Github или *Markdown Here*, поддерживают подсветку синтаксиса. Список поддерживаемых языков и способ их указания может различаться. *Markdown Here* поддерживает десятки языков (и не-языков, например синтаксис diff и заголовки HTTP); полный список и способ указания языков см. на странице [highlight.js demo-странице](http://softwaremaniacs.org/media/soft/highlight/test.html).
188 +
189 + ```no-highlight
190 + `Код` в строке обрамляется `обратными апострофами`.
191 + ```
192 +
193 + `Код` в строке обрамляется `обратными апострофами`.
194 +
195 + Блоки кода выделяются либо тремя обратными апострофами <code>```</code> либо четырьмя пробелами в каждой строке. Рекомендуется использовать три апострофа -- они проще и только они поддерживают подсветку синтаксиса.
196 +
197 + <pre lang="no-highlight"><code>```javascript
198 + var s = "Подсветка JavaScript";
199 + alert(s);
200 + ```
201 +
202 + ```python
203 + s = "Подсветка Python"
204 + print s
205 + ```
206 +
207 + ```
208 + Язык не указан, синтаксис не подсвечен.
209 + Но мы вставим в него &lt;b&gt;тег&lt;/b&gt;.
210 + ```
211 + </code></pre>
212 +
213 +
214 +
215 + ```javascript
216 + var s = "Подсветка JavaScript";
217 + alert(s);
218 + ```
219 +
220 + ```python
221 + s = "Подсветка Python"
222 + print s
223 + ```
224 +
225 + ```
226 + Язык не указан, синтаксис не подсвечен (некоторые обработчики все же подсвечивают).
227 + Но мы вставим в него <b>тег</b>.
228 + ```
229 +
230 +
231 + <a name="tables"><h2>Таблицы</h2></a>
232 +
233 + Таблицы не являются частью Markdown, но многие обработчики, например *Markdown Here* и Github, поддерживают их. Они позволяют легко добавить таблицы в электронное письмо -- в других случаях для этого нужно копировать их из другого приложения.
234 +
235 + ```no-highlight
236 + Вертикальные линии обозначают столбцы.
237 +
238 + | Таблицы | Это | Круто |
239 + | ------------- |:------------------:| -----:|
240 + | столбец 3 | выровнен вправо | $1600 |
241 + | столбец 2 | выровнен по центру | $12 |
242 + | зебра-строки | прикольные | $1 |
243 +
244 + Внешние вертикальные линии (|) не обязательны, и они нужны только чтобы сам код Markdown выглядел красиво. Тот же код можно записать так:
245 +
246 + Markdown | не такой | красивый
247 + --- | --- | ---
248 + *Но выводится* | `так же` | **клево**
249 + 1 | 2 | 3
250 + ```
251 +
252 + Вертикальные линии обозначают столбцы.
253 +
254 + | Таблицы | Это | Круто |
255 + | ------------- |:------------------:| -----:|
256 + | столбец 3 | выровнен вправо | $1600 |
257 + | столбец 2 | выровнен по центру | $12 |
258 + | зебра-строки | прикольные | $1 |
259 +
260 + Внешние вертикальные линии (|) не обязательны, и они нужны только чтобы сам код Markdown выглядел красиво. Тот же код можно записать так:
261 +
262 + Markdown | не такой | красивый
263 + --- | --- | ---
264 + *Но выводится* | `так же` | **клево**
265 + 1 | 2 | 3
266 +
267 + <a name="blockquotes"><h2>Цитаты</h2></a>
268 +
269 + ```no-highlight
270 + > С помощью цитат очень удобно в письме обозначать исходный текст.
271 + > Эта строка - часть той же цитаты.
272 +
273 + Разрыв цитаты.
274 +
275 + > Это очень длинная строка, но она будет правильно процитирована даже при размещении на нескольких строках. Продолжаем писать, чтобы эта строка не вмещалась на одной строке в любом окне. Кстати, в цитаты можно *вставлять* даже **Markdown**.
276 + ```
277 +
278 + > С помощью цитат очень удобно в письме обозначать исходный текст.
279 + > Эта строка - часть той же цитаты.
280 +
281 + Разрыв цитаты.
282 +
283 + > Это очень длинная строка, но она будет правильно процитирована даже при размещении на нескольких строках. Продолжаем писать, чтобы эта строка не вмещалась на одной строке в любом окне. Кстати, в цитаты можно также *размечать* с помощью **Markdown**.
284 +
285 + <a name="html"><h2>Встроенный HTML</h2></a>
286 +
287 + Часто Markdown понимает чистый HTML.
288 +
289 + ```no-highlight
290 + <dl>
291 + <dt>Список определений</dt>
292 + <dd>Это то, что люди иногда используют.</dd>
293 +
294 + <dt>Markdown внутри HTML</dt>
295 + <dd>Работает *не очень** хорошо. Используйте HTML-<em>теги</em>.</dd>
296 + </dl>
297 + ```
298 +
299 + <dl>
300 + <dt>Список определений</dt>
301 + <dd>Это то, что люди иногда используют.</dd>
302 +
303 + <dt>Markdown внутри HTML</dt>
304 + <dd>Работает *не очень** хорошо. Используйте HTML-<em>теги</em>.</dd>
305 + </dl>
306 +
307 + <a name="hr"><h2>Горизонтальные линии</h2></a>
308 +
309 + ```
310 + Три и более...
311 +
312 + ---
313 +
314 + Дефисы
315 +
316 + ***
317 +
318 + Звездочки
319 +
320 + ___
321 +
322 + Подчеркивания
323 + ```
324 +
325 + Три и более...
326 +
327 + ---
328 +
329 + Дефисы
330 +
331 + ***
332 +
333 + Звездочки
334 +
335 + ___
336 +
337 + Подчеркивания
338 +
339 + <a name="lines"><h2>Новая строка</h2></a>
340 +
341 + Для понимания работы разрыва строка автор главным образом рекомендует экспериментировать и пробовать -- нажмите &lt;Enter&gt; один раз (т.е. перейдите на новую строку), потом нажмите дважды (т.е. вставьте две новые строки) и посмотрите что приозошло. Вы сразу поймете что вам нужно. В расширении [Markdown Here](https://github.com/adam-p/markdown-here) для браузеров есть удобная функция "Markdown Toggle", которая поможет в этом.
342 +
343 + *Примечание переводчика:*
344 + *Для переноса на новую строку в конце предыдущей строки необходимо добавить* **два пробела**. *Без этого большинство парсеров Markdown не выполняют переход на новую строку.*
345 +
346 + Попробуйте ввести следующее:
347 +
348 + ```
349 + Это начальная строка
350 +
351 + Эта строка отделена от предыдущей двумя новыми строками и станет *отдельным абзацем*.
352 +
353 + Это тоже отдельный абзац, но...⋅⋅
354 + Эта строка отделена одной новой строкой, поэтому она находится в *том же абзаце*.
355 + ```
356 +
357 + Это начальная строка
358 +
359 + Эта строка отделена от предыдущей двумя новыми строками и станет *отдельным абзацем*.
360 +
361 + Это тоже отдельный абзац, но...`[здесь два пробела]`
362 + Эта строка отделена одной новой строкой, поэтому она находится в *том же абзаце*.
363 +
364 + (Примечание: В [Markdown Here](https://github.com/adam-p/markdown-here) разрывы строк ведут себя так же, как в [GFM](https://help.github.com/articles/github-flavored-markdown), поэтому не нужно вставлять по две новые строки.)
365 +
366 + <a name="videos"><h2>Видео Youtube</h2></a>
367 +
368 + Ролики нельзя вставить напрямую, но можно вставить изображение со ссылкой на видео, например:
369 +
370 + ```no-highlight
371 + <a href="http://www.youtube.com/watch?feature=player_embedded&v=ID_ВИДЕОРОЛИКА_НА_YOUTUBE" target="_blank"><img src="http://img.youtube.com/vi/ID_ВИДЕОРОЛИКА_НА_YOUTUBE/0.jpg"
372 + alt="ALT-ТЕКСТ ИЗОБРАЖЕНИЯ" width="240" height="180" border="10" /></a>
373 + ```
374 +
375 + На чистом Markdown, но без размеров изображения и рамки:
376 +
377 + ```no-highlight
378 + [![ALT-ТЕКСТ ИЗОБРАЖЕНИЯ](http://img.youtube.com/vi/ID_ВИДЕОРОЛИКА_НА_YOUTUBE/0.jpg)](http://www.youtube.com/watch?v=ID_ВИДЕОРОЛИКА_НА_YOUTUBE)
379 + ```
Новее Позже

Работает на Opengist ⋅ Load: 14ms⋅

Русский