Комментарии и метаданные

Комментарии и метаданные — это элементы разметки, которые не отображаются в собранном файле. Они используются, чтобы хранить в исходном тексте информацию для SEO или авторов документа.

Комментарии

Чтобы добавить комментарий, используйте следующую разметку. Убедитесь, что до комментария есть пустая строка.

[//]: # (Комментарий)

Метаданные

Метаданные можно добавить в формате YAML в начало файла для настроек отображения страницы.

Пример:

---
title: Заголовок
description: Описание
---

Поддерживаемые параметры:

Название

Описание

Тип и значение по умолчанию

copyright

Указание владельца контента страницы.

Прописывается в <meta name="copyright" content="..."/>

string

—

description

Мета-описание страницы.

Прописывается в <meta name="description" content="..."/>

string

—

keywords

Список ключевых слов страницы для поисковых роботов.

Прописывается в мета-тег <meta name="keywords" content="keyword1,keyword2,..."/>

string[]

—

interface

Секция с настройками отображения интерфейса. Переопределяет установленные в одноимённой секции .yfm настройки для текущей страницы.

Пример с отключением оглавления на странице
---
interface:
  toc: false
---

object

undefined

resources

Секция для управления ресурсами страницы.

Переопределяет настройки resources, установленные в секции resources .yfm.

Важно

Доступно только расширение списка значений csp.

object

undefined

title

Мета-заголовок страницы.

Прописывается в <meta name="..." content="..."/>.

string

—
Предыдущая
Фрагменты кода
Следующая
Переменные