Write Content of Pages

Estimated reading time: 6 minutes

Pages of this site are mainly written in Markdown. The detailed syntax could be found in kramdown syntax. Here are some brief instructions.

Front Matter

Front matter is necessary for each page. It must be at the beginning of the file surrounded by triple-dashed lines, or the page will not be generated correctly. Please make sure the title of page is written here.

---
title: The Title of This Page
---

Front matter is not a part of Markdown syntax. Find details in jekyll docs.

Paragraphs

Consecutive lines of text are considered to be one paragraph. You have to add a blank line to separate paragraphs.


This is a paragraph
written in more than
one line.

This is a new paragraph.

This is a paragraph written in more than one line.

This is a new paragraph.


Headers are the title for each section or subsection. A line start with one or more # is considered to be a header. The number of # indicates the level for this header.


# This is header 1
## This is header 2
### This is header 3
#### This is header 4
##### This is header 5
###### This is header 6

This is header 1

This is header 2

This is header 3

This is header 4

This is header 5
This is header 6

There could be 6 header levels at most.

List

Ordered list:

1. This is a list item
2. And another item
   with additional text
  1. This is a list item
  2. And another item with additional text

Unordered list:

* This is a list item
* And another item
  • This is a list item
  • And another item

Nested list:

1. Item one
   * sub item one
   * sub item two
   * sub item three
2. Item two
  1. Item one
    • sub item one
    • sub item two
    • sub item three
  2. Item two

Emphasis

Emphasis can be added to text by surrounding the text with either asterisks or underscores. Strong emphasis can be done by doubling the delimiters.


This is *emphasized*,
_this_ too!

This is **strong**,
__this__ too!

This is emphasized, this too!

This is strong, this too!



[CEPC](http://cepc.ihep.ac.cn) is a Higgs Factory.

Or

[CEPC] is a Higgs Factory.

[CEPC]: http://cepcsoft.ihep.ac.cn

CEPC is a Higgs Factory.


A direct link could be written surrounded by <>:


<http://cepc.ihep.ac.cn>

http://cepc.ihep.ac.cn


Image

The width and height could be set.


![CEPC Logo](/guides/web/images/cepclogo.png)

![CEPC Logo](/guides/web/images/cepclogo.png){:width="200px"}

CEPC Logo

CEPC Logo


Mathematic Formular

Equations written with are also supported. Mathematic formular should be surrounded by $$.


$$e^+e^- \to ZH$$

$$ H \to b\bar{b},c\bar{c},gg $$

This is an inline formular $$H \to \gamma\gamma$$.

This is an inline formular .


Note that LaTeX code that uses the pipe symbol | in inline math statements may lead to a line being recognized as a table line. This problem can be avoided by using the \vert command instead of |!

Code Block

Code blocks should be surrounded by three backticks `. The language name can also be specified at the end of the first line in order to activate the highlight of the codes. Inline codes are surrounded by single backtick `.


```c++
#include <iostream>

int main() {
  return 0;
}
```

This is some inline codes `#include <iostream>`.

#include <iostream>

int main() {
  return 0;
}

This is some inline codes #include <iostream>.


Table

|---
| Default aligned | Left aligned | Center aligned | Right aligned
|-|:-|:-:|-:
| First body part | Second cell | Third cell | fourth cell
| Second line |foo | **strong** | baz
| Third line |quux | baz | bar
|===
| Footer row
Default aligned Left aligned Center aligned Right aligned
First body part Second cell Third cell fourth cell
Second line foo strong baz
Third line quux baz bar
Footer row      

Footnotes

The corresponding definitions could be found at the bottom of the page.


This is a text with a
footnote[^note1].

Other text with footnote[^newnote].

[^note1]: And here is the definition.
[^newnote]: Another definition.

This is a text with a footnote1.

Other text with footnote2.


Abbreviation

CEPC is a Higgs Factory.

*[CEPC]: Circular Electron Positron Collider

CEPC is a Higgs Factory.

Horizontal Line

A horizontal line could be used to separate contents. Just use three or more asterisks, dashes or underscores.

---
* * *


HTML Elements

HTML elements starts by a HTML tag (div, span, p, pre, …)


This is <span style="color: red">written in
red</span>.

This is written in red.


Footnote Definition

The previous written footnote definitions are here at the bottom of the page.

References

  1. And here is the definition. 

  2. Another definition.