docs: add documentations

exampleSite/content/docs/guide/syntax-highlighting.md

@@ -0,0 +1,87 @@
+---
+title: "Syntax Highlighting"
+weight: 3
+---
+
+Hugo uses [Chroma](https://github.com/alecthomas/chroma), a general purpose syntax highlighter in pure Go, for syntax highlighting.
+It is recommended to use backticks for code blocks in Markdown content. For example:
+
+````markdown {filename="Markdown"}
+```python
+def say_hello():
+    print("Hello!")
+```
+````
+
+will be rendered as:
+
+```python
+def say_hello():
+    print("Hello!")
+```
+
+## Features
+
+### Filename
+
+To add a filename or title to the code block, set attribute `filename`:
+
+````markdown {filename="Markdown"}
+```python {filename="hello.py"}
+def say_hello():
+    print("Hello!")
+```
+````
+
+```python {filename="hello.py"}
+def say_hello():
+    print("Hello!")
+```
+
+### Line Numbers
+
+To set line numbers, set attribute `linenos` to `table` and optionally set `linenostart` to the starting line number:
+
+````markdown {filename="Markdown"}
+```python {linenos=table,linenostart=42}
+def say_hello():
+    print("Hello!")
+```
+````
+
+```python {linenos=table,linenostart=42}
+def say_hello():
+    print("Hello!")
+```
+
+### Highlighting Lines
+
+To highlight lines, set attribute `hl_lines` to a list of line numbers:
+
+````markdown {filename="Markdown"}
+```python {linenos=table,hl_lines=[2,4],linenostart=1,filename="hello.py"}
+def say_hello():
+    print("Hello!")
+
+def main():
+    say_hello()
+```
+````
+
+```python {linenos=table,hl_lines=[2,4],linenostart=1,filename="hello.py"}
+def say_hello():
+    print("Hello!")
+
+def main():
+    say_hello()
+```
+
+
+### Copy Button
+
+By default, copy button is enabled for code blocks.
+
+
+## Supported Languages
+
+For a list of supported languages, please see [Chroma's documentation](https://github.com/alecthomas/chroma#supported-languages).