Перейти к содержанию

Разметка файлов .md

В книге проекта или на вики-страницах GitFlic есть возможность форматирования контента с помощью разметки Markdown.

Разметка обычного текста

  • **или __ выделяет текст полужирным
  • * или _ выделяет текст курсивом
  • <u></u> подчеркивает текст
  • \ *экранирует* символ перед собой

Разметка контента

# Заголовки

Заголовки обозначаются с помощью символов #. Несколько символов подряд делают заголовок меньше – например, после заголовка # можно разместить подзаголовки ##, ### и т.д.

В качестве альтернативы может использоваться: - строка вида ======== вместо # - строка вида -------- вместо ##

Заголовок первого уровня
========================

И заголовок второго уровня
--------------------------

{# Якорные ссылки }

Добавив в строку заголовка, справа, конструкцию {#имя_якоря}, в дальнейшем вы сможете создать ссылку именно на этот раздел страницы.

- Списки

Создать ненумерованный список можно с помощью символов -, + или * перед началом строки. Такие списки поддерживают табуляцию: - Пункт 1 - Пункт 2 + Пункт 2.1 - Пункт 2.1.1 + Пункт 3 

- Пункт 1
- Пункт 2
    + Пункт 2.1
        - Пункт 2.1.1
+ Пункт 3

Нумерованные списки выглядят следующим образом:

  1. Пункт 1
  2. Пункт 2
    1. Пункт 2.1
      1. Пункт 2.1.1
1. Пункт 1
2. Пункт 2
    1.  Пункт 2.1
        1. Пункт 2.1.1

> Цитирование

Добавить цитату или просто выделить текст можно с помощью символа > перед началом строки:

Человек бессмертен благодаря познанию.

> Человек бессмертен благодаря познанию.

| Таблицы |

Расположить содержимое в виде таблицы можно специальной структурой символов | и -.

Пример таблицы:

Символ Назначение
| Разделение столбцов
- Отделение строки заголовков 
| Символ | Назначение                  |
|--------|-----------------------------|
| \|     | Разделение столбцов         |
| -      | Отделение строки заголовков |

Фрагменты кода

Однострочный фрагмент кода можно выделить с помощью одинарного ` или двойного ``.
Многострочный фрагмент с функцией быстрого копирования можно добавить, используя ```: 

Этот многострочный фрагмент
Можно скопировать кнопкой

При необходимости можно указать язык программирования или дополнительные сведения:

``` Markdown

Ваш текст

```

Медиа-контент

Изображения

Для того чтобы добавить изображение из проекта, можно использовать конструкцию: Обложка 

![Подпись](../относительный/путь/до/изображения.png)

Или изображение с внешнего источника: GitFlic 

![Подпись](https://ссылка_на_изображение.png)

Есть возможность добавления гиперссылок: - на внешний ресурс: GitFlic, 

[GitFlic](https://gitflic.ru)
- на внутреннюю страницу: краткое руководство 
 [краткое руководство](../../common/guide)
- на отмеченный раздел внутренней страницы: якорные ссылки 
[якорные ссылки](../markdown#anchor)