Quail uses GitHub Flavored Markdown Spec as the basic syntax for writing posts. Please refer to the GFM spec for more details.
Some syntaxes are not supported by GFM, but are supported by Quail. They are listed below.
Most of following syntax are currently rendered in the client browser only, and cannot be displayed in Email.
Emphasis
Strikethrough
highlight text
~~Strikethrough~~
==highlight text==
Footnotes
Quail supports PHP Markdown Extra style footnotes. Each footnote consists of two parts: a marker in the text that will become a superscript number [^N], and the footnote itself that will appear at the bottom of the document.
The footnote marker in the text can be placed anywhere in the document, but the footnote itself will always appear at the bottom of the document.
Here is an example:
"The road to hell is paved with good intentions" is a proverb or aphorism.
An alternative form is "Hell is full of good meanings, but heaven is full of good works".[^1]
The exact origin of this proverb is unknown and several variations exist.
It appeared in full in a London newspaper in 1828 where it was referred to as a Portuguese proverb.[^2]
It was also published in Henry G. Bohn's A Hand-book of Proverbs in 1855.[^3]
...
[^1]: "the road to Hell is paved with good intentions", Proverbs, Infobase Publishing, 2007, p. 234, ISBN 9780816066735
[^2]: "2 Nov 1828, 1 - The Weekly Dispatch at Newspapers.com". Newspapers.com. Retrieved 2022-04-11.
[^3]: Bohn, Henry (1855), A Hand-book of Proverbs
Images
Add caption to an image:
A girl and a boy, is playing in the yard
Specify a width to an image:
Embeded Video and Object
3rd-party video link and object can be embedded in Quail posts. Currently, Quail supports the following video and object providers:
- YouTube
- Bilbili
- X.com (formerly Twitter)
- TradingView
- Quail's List and Post
The embeded video and object syntax is the same as the one used for images:
They will be rendered as:
There's carbon on Jupiter's moon Europa—and it most likely came from an ocean below the surface! https://t.co/JHZpi16cwq
— NASA (@NASA) September 21, 2023
In October 2024, @EuropaClipper will launch to take a closer look. You can send your name to space with it by signing up here: https://t.co/PT7fCIfkZy pic.twitter.com/RoHpe9AWxU
Fence Blocks
The fence block syntax can be used to create a stylised block of text. The syntax starts with ::: and ends with :::.
The first line of the block is the type and title of the block, and the rest of the block is the content.
The predefined block types are: info, tip, warning, danger, info
Here is some examples:
:::info
This is a block of information, usually used to inform readers of some extra information. For example: grapes are a kind of fruit that can be eaten.
:::
:::tip
This is a tip, usually used to tell readers some tips. For example: you can eat grapes without spitting out the skin.
:::
:::warning
This is a warning, usually used to warn readers. For example: if you don't chew grapes, you may choke, please pay attention to the grapes in your mouth.
:::
:::danger
This is a danger message, usually used to emphasize dangerous operations. For example: choking on grapes can lead to death, please be careful!
:::
This is a block of information, usually used to inform readers of some extra information. For example: grapes are a kind of fruit that can be eaten.
This is a tip, usually used to tell readers some tips. For example: you can eat grapes without spitting out the skin.
This is a warning, usually used to warn readers. For example: if you don't chew grapes, you may choke, please pay attention to the grapes in your mouth.
This is a danger message, usually used to emphasize dangerous operations. For example: choking on grapes can lead to death, please be careful!
Writer can also offer a title for the block:
:::danger Serious Announcement
The grapes are innocent, please do not ban the planting of grapes because eating grapes can lead to death.
:::
The grapes are innocent, please do not ban the planting of grapes because eating grapes can lead to death.
Equation, formula
Quail uses MathJax to render equations and formulas. This is useful for writing scientific and engineering articles (please enable "Enable MathJax" at the post options), for example:
$$
\int f(x)dx \\
\int_1^\infty \frac{1}{x^2}dx
$$
will be rendered as:
\[\int f(x)dx \\ \int_1^\infty \frac{1}{x^2}dx \]
Mermaid Diagrams
Quail uses mermaid.js to render diagrams, which is also a great tool for writing scientific and engineering articles.
The syntax is as follows:
sequenceDiagram
Alice->>John: Hello John, how are you?
John-->>Alice: Great!
Alice-)John: See you later!
```mermaid
sequenceDiagram
Alice->>John: Hello John, how are you?
John-->>Alice: Great!
Alice-)John: See you later!
```
