Skip to content

example-md.md

Latest commit

 

History

History
210 lines (136 loc) · 7.17 KB

example-md.md

File metadata and controls

210 lines (136 loc) · 7.17 KB

≡ Краткое руководство Markdown

Заголовок h1

Заголовок h2

Заголовок h3

Заголовок h4

Заголовок h5
Заголовок h6

Абзац Markdown. Пример:

Lorem ipsum dolor sit amet... Абзацы создаются при помощи пустой строки.

Для переноса строки делаем два пробела     в конце (предыдущей) строки Перенос строки

Получается? Отлично! 👍

Текст с жирным начертанием (strong) и курсив (italic) в Markdown:

1 символ _ или * для наклонного текста 2 символа __ или ** для жирного текста 3 символа ___ или *** для наклонного и жирного одновременно.

Перечеркнутый текст. 2 тильды ~ до и после текста - текст как перечеркнутый - Зачеркнуто

Горизонтальная черта. hr - 3 звездочки или 3 дефиса

♦ Маркированный список. Для разметки неупорядоченных списков *, -, +:

  • текст
  • текст
  • текст

Вложенные пункты. 4 пробела перед маркером:

  • элемент маркированного списка
  • элемент маркированного списка
    • вложенный текст
    • вложенный текст

Нумерованный список. Главное, чтобы перед элементом списка стояла цифра с точкой.

  1. элемент нумерованного списка
  2. элемент нумерованного списка
    1. вложенный
    2. вложенный

Можно сделать так:

  1. текст
  2. текст
  3. текст

Список с абзацами:

  • Текст

  • Текст

  • Текст

    Текст (4 пробела или Tab).

♦ Ссылки Markdown

Здесь - ссылка с title.

Здесь - ссылка без title.

Ссылки с разметкой как у сносок.

Здесь - ссылка продолжение текста ссылка продолжение текста ссылка. Просто ссылка без указания id.

Ссылки-сноски можно располагать в любом месте документа.

Цитаты в Markdown - cимвол >.

Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet.

Lorem ipsum dolor sit amet.

В цитаты можно помещать всё что угодно, в том числе вложенные цитаты:

Заголовок.

  1. список
  2. список

Вложенная цитата.

Исходный код (4 пробела в начале строки):

$source = file_get_contents('example.php');
Исходный код в Markdown

В GFM - поставить 3 апострофа (где Ё) до и после кода. Можно указать язык исходного кода.

<div class="as-header">
    <h1>Матрёшка</h1>
    <p>Lorem ipsum dolor sit amet.</p>
</div>
    $(function() { ... });

Для вставки кода внутри предложений - надо обрамить в апострофы (где Ё).

Пример: <div class="as-markdown">.

Если внутри кода есть апостроф, то код надо обрамить двойными апострофами: Бла-бла (`) тут.

Картинки в Markdown

Картинка без alt текста

Картинка с alt и title:

Alt text

Картинка-ссылка: Подсказка: синтаксис как у ссылок, только перед открывающей квадратной скобкой ставится восклицательный знак.

Alt text

Картинки-сноски:

Картинка Картинка Картинка

Использование HTML внутри Markdown

Mожно смешивать Markdown и HTML. Если на какие-то элементы нужно поставить классы или атрибуты, используем HTML:

Выделим слова без помощи * и _ . Например, это курсив и это тоже курсив. А вот так уже strong, и так тоже strong.

Можно и наоборот, внутри HTML-тегов использовать Markdown.

Markdown внутри HTML. Пример:

Выделять слова можно при помощи * и _ . Например, это курсив и это тоже italic. А вот так уже strong, и так тоже strong.

Таблицы

В чистом Маркдауне нет синтаксиса для таблиц, а в GFM есть. Рисуем:

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

Можно по бокам линии нарисовать:

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

Можно управлять выравниванием столбцов при помощи двоеточия:

Left-Aligned Center Aligned Right Aligned
col 3 is какой-то текст my text
col 2 is центр $123
Content Cell бука $7

Внутри таблиц можно использовать ссылки, наклонный, жирный или зачеркнутый текст.

♦ Для всего остального есть обычный HTML.

Links: