Basic Guide to Write a Note

1—Writing a Note link

To write a note, you must be logged in. Open the side menu menu > Start Writing.

Don’t forgot to edit your note’s title at the top of the editor!

Use # to create headings, for example:

# Heading 1

## Subheading 1 to Heading 1

### Sub-sub-heading to Sub-heading 1

## Subheading 2 to Heading 1

To add your heading to the content list, add a unique ID to your heading.
You could add an ID to your heading by adding {#some-id} after the heading, like:

# Heading that will appear in the content list {#and-this-is-the-id}

It’s recommended to use kebab-case for the heading ID, meaning hyphens are used for spaces, and no capital letters. For example, this-is-a-text-written-using-kebab-case.

Heading 1 (H1 for short) is often referred to as the “main heading”, while H2–H6 are referred to as “subheadings” because they indicate sub-levels.

Normal text is automatically a paragraph.
And to separate a paragraph, add an empty line; for example:

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate nostrum
eaque modi molestiae officiis. Veniam magni, quam harum deserunt dignissimos
impedit quo itaque doloribus debitis molestiae adipisci quas inventore
reprehenderit. *Put an empty line after this*.

*Put an empty line before this*. Lorem, ipsum dolor sit amet consectetur
adipisicing elit. Cumque voluptatem voluptatum ad vero nemo aliquid eligendi
asperiores rerum, neque rem inventore temporibus velit voluptates quam quo iure?
Repellat voluptate voluptates enim laboriosam asperiores sapiente, provident
incidunt accusamus illum deleniti vero!

To get:

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate nostrum eaque modi molestiae officiis. Veniam magni, quam harum deserunt dignissimos impedit quo itaque doloribus debitis molestiae adipisci quas inventore reprehenderit. Put an empty line after this.

Put an empty line before this. Lorem, ipsum dolor sit amet consectetur adipisicing elit. Cumque voluptatem voluptatum ad vero nemo aliquid eligendi asperiores rerum, neque rem inventore temporibus velit voluptates quam quo iure? Repellat voluptate voluptates enim laboriosam asperiores sapiente, provident incidunt accusamus illum deleniti vero!

If you want to add a new line (line break) without creating a new paragraph, add two spaces at the end of the line to add a line break, for example:

This is some text, a line of text, add two spaces after this␣␣
and this is a text after a line break.

to get:

This is some text, a line of text, add two spaces after this
and this is a text after a line break.

Kyanit uses Github Flavoured Markdown (GFM) to style text (by using the module marked.js).

Type **bold** to get bold.

Type *italic* to get italic.

Type ~strike~ to get strike.

Type `code` to get code.

Type [Link Text](https://example.com) to get Link Text.

Or use <https://example.com> if you don’t want to add the text, https://example.com.

Type

This is not a part of markdown syntax, but a part of GFM[^gfm]. This will be followed by another footnote.[^2]

[^gfm]: GitHub Flavoured Markdown.
[^2]: Another footnote.

to get

This is not a part of markdown syntax, but a part of GFM[1]. This will be followed by another footnote.[2]

You can place the foot note definition ([^1]: Definition) anywhere, marked.js will automatically put it at the bottom.

You also can label the footnote anyway you like, [^1], [^footnote], [^one two three], and so on, marked.js will automatically number it.

If you want more styling, you can use HTML.

Type ![Alt text](/assets/header.svg) to get Alt text

1.6.1—Ordered

Type:

1. This
2. Is
3. An
4. Ordered
5. List

to get:

  1. This
  2. Is
  3. An
  4. Ordered
  5. List

1.6.2—Unordered

Type:

- This
- Is
- Unordered
- List

alternatively, you can use + and * instead of -; to get:

1.6.3—Nested

Type:

- This is unordered
	1. That have an ordered list
		A. That have another one
		B. Like this.
	2. This is the second list
- More
	i. And this too

to get:

Type:

> This is a block quote.

to get:

This is a block quote.

Type:

```js
// some code
const CONSTANT = 400;
console.log(400);
```

to get:

// some code
const CONSTANT = 400;
console.log(400);

Type at least 3 hyphens, asterisks, or underscores to create a horizontal rule, and add an empty line before the hyphens. For example:

Below this text are three horizontal rules.

---

***

___

to get:

Below this text are three horizontal rules.




If you don't add an empty space, the text will be a heading 1.

Type:

| Heading 1         | Heading 2                 |
| ----------------- | ------------------------- |
| Some table cells  | Some another table cells  |
| Lorem ipsum       | muspi meroL               |

to get:

Heading 1 Heading 2
Some table cells Some another table cells
Lorem ipsum muspi meroL

Kyanit uses MathJax to display math equations and uses LaTeX syntax.

If you don't want to bother to learn LaTeX, you could use https://latexeditor.lagrida.com/.

1.11.1—Inline Math

Use single dollar sign $ for inline math.

Type

$\sin(\alpha) = \frac{a}{b} = \text{sine wave}$

to write $ \sin(\alpha) = \frac{a}{b} = \text{sine wave} $.

Inline math, as the name suggest, will display the math equation in the same line of the paragraph.

1.11.2—Display Math

Use double dollar sign $$ for display (block) math.

Type

$$ \begin{align*}
	\tan(\beta) = \frac{\sin}{\cos} &= \text{tangent}. \\\\
	\Aboxed{f(x) &= x^2}
\end{align*} $$

to write

$$ \begin{align*} \tan(\beta) = \frac{\sin}{\cos} &= \text{tangent}. \\ \Aboxed{f(x) &= x^2} \end{align*} $$

Display math will be displayed centered and on a separate line.

1.12—Alert

There are 14 types of alert:

Type Color Icon
Note Blue edit
Info Blue info
Abstract Light Blue assignment
Todo Light Blue check_circle
Tip Green lightbulb
Success Green check
Question Orange help
Warning Orange warning
Failure Red close
Danger Red dangerous
Bug Red bug_report
Important Purple assignment_late
Example Purple list
Quote Black/White format_quote

To make them, write as follows.

> [!type] Title (Optional)
> Contents.

Where type is one of the 14 types (case-insensitive)[3], and the title is optional. When there is no title, the type will be displayed.

For example:

> [!example]
> This is an **example** alert.

will render to

listExample

This is an example alert.

For titled example:

> [!quote] Here is a title
> This is a **quote** alert.

will render to

format_quoteHere is a title

This is a quote alert.

Here is 14 of them rendered.

editNote

This is a note alert.

infoInfo

This is an info alert.

assignmentAbstract

This is an abstract alert.

check_circleTodo

This is a todo alert.

lightbulbTip

This is a tip alert.

checkSuccess

This is a success alert.

helpQuestion

This is a question alert.

warningWarning

This is a warning alert.

closeFailure

This is a failure alert.

dangerousDanger

This is a danger alert.

bug_reportBug

This is a bug alert.

assignment_lateImportant

This is an important alert.

listExample

This is an example alert.

format_quoteQuote

This is a quote alert.

2—Publishing link

After you’re done, you can publish your note by clicking the publish button at top-right corner. If you click it, it will open a dialog box that says

Thumbnail URL
[_____________________]

Keywords
[_____________________]

3—Visibility link

Visibility: Public means everyone can search your note, or see it on your profile.

Visibility: Unlisted means only someone with the link that can open your note.


Footnotes

  1. GitHub Flavoured Markdown.

  2. Another footnote.

  3. Typing [!EXAMPLE] will result in the same output as [!example], [!Example], etc.