Quaily 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 Quaily. They are listed below.
Most of following syntax are currently rendered in the client browser only, and cannot be displayed in Email.
Text Styles
~~Strikethrough~~
==highlight text==
Use <kbd>Ctrl</kbd> + <kbd>C</kbd> or <kbd>⌘</kbd> + <kbd>C</kbd> to copy things.
Strikethrough
highlight text
Use Ctrl + C or ⌘ + C to copy things.
Footnotes
Quaily 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 Objected
3rd-party video link and object can be embedded in Quaily posts. Currently, Quaily supports the following video and object providers:
- YouTube Embeded
- Bilbili Embeded
- X.com (formerly Twitter)
- TradingView
- Quaily's List and Post
- Dify Embeded
- Spotify Embeded
- HTML5 Audio
The embed syntax is the same as the one used for images:
YouTube & Bilibili
X.com (formerly Twitter)
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
TradingView
Quaily Channels and Posts
Dify Widget
Spotify Embed
HTML5 Audio
Callouts
The github-style callouts is supported as well.
> [!NOTE]
> Highlights information that users should take into account, even when skimming.
> [!TIP]
> Optional information to help a user be more successful.
> [!IMPORTANT]
> Crucial information necessary for users to succeed.
> [!WARNING]
> Critical content demanding immediate user attention due to potential risks.
> [!CAUTION]
> Negative potential consequences of an action.
Highlights information that users should take into account, even when skimming.
Optional information to help a user be more successful.
Crucial information necessary for users to succeed.
Critical content demanding immediate user attention due to potential risks.
Negative potential consequences of an action.
Fenced Divs
The fenced 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, important, 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
Quaily 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
Quaily 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!
```
