Kramdown в Jekyll

29 января 2016

Markdown очень удобно использовать при написании технической документации. Для оформления проектов на Github, его возможностей тоже хватает. Но для более творческого применения, например, ведения блога, возникает потребность в дополнительных визуальных средствах. В таких случаях автору контента стоит обратить внимание на Kramdown. С его помощью можно присваивать классы и атрибуты элементам Markdown разметки, делая их разнообразными (в пользу эстетики)

Настройка:

Для начала (если хостинг на gh-pages), нужно внести кое-какие изменения в конфигурационный файл:

  # _config.yml
  markdown: kramdown  
  kramdown:  
    input: GFM

Классы и ID:

  Обычный абзац с идентификатором (с id).
  {: #article-one}

  > Цитата с атрибутом "title" и идентификатором "myid"
  {:title="Данная цитата принадлежит мыслителю..."}
  {: #myid}

  * {:.my-class} Этому элементу присвоин класс "my-class"

  {:.ruby}
      Какой-то код

Аббревиатуры:

  Этот текст написан на другом языке программирования, HTML здесь не причём!

  *[другом языке]: Его название — Markdown
  *[HTML]: HyperTextMarkupLanguage (переводится как — «Язык гипертекстовой разметки»)

Сноски:

  Какой-то текст.[^1]. Другой какой-то текст.[^footnote].

  [^1]: Определение сноски (текст) из фразы «Какой-то текст»
  [^footnote]: Определение сноски или слова (текст) из фразы «Другой какой-то текст»

Ссылки на полезные ресурсы:

http://kramdown.gettalong.org/syntax.html
http://kramdown.gettalong.org/parser/kramdown.html

Для справки: GFM расшифровывается как Github Flavored Markdown