mirror of https://github.com/status-im/codimd.git
150 lines
2.6 KiB
Markdown
150 lines
2.6 KiB
Markdown
---
|
|
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
|
|
```
|
|
|
|
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
|
|
langs: 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 CodiMD 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: codimd
|
|
```
|
|
|
|
slideOptions
|
|
---
|
|
This option allow 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
|
|
```
|