Supported YAML metadata

--- robots: index, follow lang: en dir: ltr breaks: true --- 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** ```xml title: meta title ``` description --- This option will set the note description. > default: not set **Example** ```xml description: meta description ``` image --- This option will set the note default image (for link preview). > default: \<HackMD default card image\> **Example** ```xml image: https://hackmd.io/screenshot.png ``` tags --- This option will set the tags which prior than content tags. > default: not set **Example** ```xml tags: features, cool, updated ``` robots --- This option will give below meta in the note head meta: ```xml <meta name="robots" content="your_meta"> ``` So you can prevent any search engine index your note by set `noindex, nofollow`. > default: not set **Example** ```xml 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** ```xml 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** ```xml 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** ```xml breaks: false ``` GA --- This option allow you to enable Google Analytics with your ID. > default: not set (which won't enable) **Example** ```xml GA: UA-12345667-8 ``` disqus --- This option allow you to enable Disqus with your shortname. > default: not set (which won't enable) **Example** ```xml 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** ```xml slideOptions: transition: fade theme: white ``` lintConfig --- This option allows you to customize [markdownlint](https://github.com/DavidAnson/markdownlint). You can find the details at [.markdownlint.yaml](https://github.com/DavidAnson/markdownlint/blob/main/schema/.markdownlint.yaml)。 :::warning :bulb: Always use two spaces as indention in YAML metadata! ::: ### Example ~~~md --- lintConfig: MD004: style: "consistent" MD006: false --- # Your other markdown content ~~~

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.