diff --git a/_quarto.yml b/_quarto.yml
index a2b1253d147d66ce235b40be9fe8be3ded528586..365bef618f2ca0502abb48f9a1b76d3534d8397f 100644
--- a/_quarto.yml
+++ b/_quarto.yml
@@ -2,7 +2,7 @@ project:
   type: website
 
 website:
-  title: "quarto_website_template"
+  title: "Quarto Website Template"
   navbar:
     left:
       - href: index.qmd
diff --git a/about.qmd b/about.qmd
index 0c6f4a2e73ca89172e539cf14a3009447cf51380..a2e1da79a2472bcef7ead39a9130cf8134e98521 100644
--- a/about.qmd
+++ b/about.qmd
@@ -2,8 +2,4 @@
 title: "About"
 ---
 
-About this site
-
-```{r}
-1 + 1
-```
+This is a template.
diff --git a/index.qmd b/index.qmd
index 92610b629f584ff14102eebefe6e607a601a560c..0da433c83f0faa42b6d668b5f41fcd36c173c05c 100644
--- a/index.qmd
+++ b/index.qmd
@@ -2,10 +2,40 @@
 title: "Quarto Website Template"
 ---
 
-This is a Quarto website.
+This is a Quarto website using Markdown files to write contents.
 
-To learn more about Quarto websites visit <https://quarto.org/docs/websites>.
+{{< include README.md >}}
+
+## Quarto markdown files
+
+Use Quarto markdown (`.qmd`) files to write your contents, following the [standard Markdown syntax](https://quarto.org/docs/authoring/markdown-basics.html) with the additional features to run computations, similarly to [Rmarkdown](https://rmarkdown.rstudio.com/).
+
+### Running computations
+
+You can include code chunks between ```` ```{r} ```` and ```` ``` ```` markers (with the name of the language between `{ }`), and the code as well as its output will be included, e.g. in R:
 
 ```{r}
-1 + 1
+x <- seq(0, 10, 0.1)
+plot(x, cos(x))
+```
+
+[R](https://quarto.org/docs/computations/r.html), [Python](https://quarto.org/docs/computations/python.html) and [Julia](https://quarto.org/docs/computations/julia.html) programming languages are supported, e.g. in Python:
+
+```{python}
+a = []
+for i in range(10):
+    a.append(2*i)
+print(a)
 ```
+
+> Note on Python:
+>
+> - If you use Rstudio, running R codes works seamlessly, running Python codes require to install the `reticulate` R package.
+> - From the command line, you will need the `jupyter` Python packate.
+
+### Additional tips
+
+You can include markdown (`.md`) files inside `.qmd` file with the following:
+```` markdown
+{{< include my_file.md >}}
+````