Documentation简体中文

Current experimental version · Checked 2026-10-24

On this page
  1. Everyday syntax
  2. Multiline structures
  3. Check before using extensions

Markdown cheat sheet

Everyday syntax

Goal Source example Note
Heading levels one/two # Title / ## Section Space after the marker
Paragraph Blank line between paragraphs One newline usually stays in the same paragraph
Hard line break Two trailing spaces or a backslash Prefer paragraphs unless a break is needed
Bold/italic **important** / *emphasis* Pair the markers
Strikethrough ~~old text~~ Extension supported by Yeli
Quote > Quoted text May be nested
Bullet/ordered list - Item / 1. Step Indent nested items
Task - [ ] Check / - [x] Done Extension; toggle in Edit
Inline code `value` Protects enclosed markers
Thematic break *** Put on its own line
Link [name](https://example.com) Separate label and destination
Image ![description](image.png) Embed for offline Yeli use
Escape \*literal stars\* Display marker characters

Multiline structures

```js
const ready = true;
```

| Option | Status |
| :----- | :----: |
| A      | Ready  |

A language after a code fence is a label, not a guarantee of highlighting. Tables need a delimiter row below the header.

Check before using extensions

Footnotes [^1], heading IDs {#id}, definition lists, ==highlight==, sub/superscripts, math and Mermaid depend on the implementation. They are not enabled rendering extensions in current Yeli. Bare URLs are not automatically linked either; use explicit link syntax. See the extension table.

For a guided path, start with headings and paragraphs. Bookmark this page for reference.

Take this tutorial with you

Markdown tutorialEditable handbook (.yeli.html)Markdown source (.md)

Editable HTML contains code. Open files only from trusted sources. Keep both handbooks of the same language together for cross-course links.