Supported YAML metadata

First you need to insert syntax like this at the start of the note:

---
YAML metas
---

Replace the “YAML metas” in this section with any YAML options as below.
You can also refer to this note’s source code.

title

This option will set the note title which prior than content title.

default: not set

Example

title: meta title

description

This option will set the note description.

default: not set

Example

description: meta description

image

This option will set the note default image (for link preview).

default: <HackMD default card image>

Example

image: https://hackmd.io/screenshot.png

tags

This option will set the tags which prior than content tags.

default: not set

Example

tags: features, cool, updated

robots

This option will give below meta in the note head meta:

<meta name="robots" content="your_meta">

So you can prevent any search engine index your note by set noindex, nofollow.

default: not set

Example

robots: noindex, nofollow

lang

This option will set the language of the note, that might alter some typography of it.
You can find your the language code in ISO 639-1 standard:
https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

default: not set (which will be en)

Example

lang: ja-jp

dir

This option provide to describe the direction of the text in this note.
You can only use whether rtl or ltr.
Look more at here:
http://www.w3.org/International/questions/qa-html-dir

default: not set (which will be ltr)

Example

dir: rtl

breaks

This option means the hardbreaks in the note will be parsed or be ignore.
The original markdown syntax breaks only if you put space twice, but HackMD choose to breaks every time you enter a break.
You can only use whether true or false.

default: not set (which will be true)

Example

breaks: false

GA

This option allow you to enable Google Analytics with your ID.

default: not set (which won’t enable)

Example

GA: UA-12345667-8

disqus

This option allow you to enable Disqus with your shortname.

default: not set (which won’t enable)

Example

disqus: hackmd

slideOptions

This option allows you provide custom options to slide mode.
Please below document for more details:
https://github.com/hakimel/reveal.js/#configuration

You could also set slide theme which named in below css files:
https://github.com/hakimel/reveal.js/tree/master/css/theme

Notice: always use two spaces as indention in YAML metadata!

default: not set (which use default slide options)

Example

slideOptions:
  transition: fade
  theme: white

lintConfig

This option allows you to customize markdownlint. You can find the details at .markdownlint.yaml。

Example

---
lintConfig:
  MD004:
    style: "consistent"
  MD006: false
---

# Your other markdown content