> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/vi/co-so-tri-thuc/166-writing-markdown-in-latex-documents.md).

# Viết Markdown trong tài liệu LaTeX

## Giới thiệu

Để sử dụng markdown trong tài liệu LaTeX, bạn cần tải [`markdown` gói](https://www.ctan.org/pkg/markdown) trong phần tiền đề của tài liệu:

```latex
\usepackage[settings]{markdown}
```

trong đó `[cài đặt]` là một *tùy chọn* tập hợp các tham số dùng để cấu hình hoặc bật các tính năng cụ thể của gói. Hãy tham khảo `markdown` gói [tài liệu](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) để xem [mô tả các tham số của gói (tùy chọn)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options).

Bài viết này sẽ xem xét ngắn gọn cả *nội dòng* markdown—được viết trong tài liệu của bạn—và việc nhập *external* markdown chứa trong một tệp văn bản.

* **Ghi chú khuyến nghị**: Nói chung, việc sử dụng markdown trong tài liệu LaTeX nên được xem là một lựa chọn bổ trợ và tiện lợi để soạn thảo một số thành phần nội dung của tài liệu, chứ không phải là một cú pháp thay thế để hoàn toàn thay thế chính LaTeX.

## Sử dụng các tệp markdown bên ngoài

Hãy dùng lệnh

```latex
\markdownInput{filename}
```

để chèn tệp markdown `filename`.

Ví dụ sau chèn một tệp có tên `example.md`. Hãy dùng liên kết bên dưới các khối mã để mở chúng dưới dạng một dự án Overleaf:

**`main.tex`**

```latex
\documentclass{article}
\title{Sử dụng gói markdown}
\usepackage[smartEllipses]{markdown}
\begin{document}

\markdownInput{example.md}

\end{document}
```

**`example.md`**

```latex
%% example.md

# Tôi là một tệp markdown.

Và tôi có thể làm *nhấn mạnh*.
## Với các tiêu đề phụ

> Trích dẫn khối được
> viết như thế này.
>
> Chúng có thể trải dài qua nhiều đoạn,
> nếu bạn muốn.

Dùng 3 dấu gạch ngang cho dấu gạch dài em dash. Dùng 2 dấu gạch ngang cho
các khoảng (ví dụ, "nó nằm trong các chương 12--14").
Ba dấu chấm ... sẽ được chuyển thành dấu ba chấm lửng
(miễn là bạn bao gồm tùy chọn smartEllipses
trong phần tiền đề). Unicode được hỗ trợ.
```

[Mở các tệp này dưới dạng một dự án Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BUsing+the+markdown+package%7D%0A%5Cusepackage%5BsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5CmarkdownInput%7Bexample.md%7D%0A%0A%5Cend%7Bdocument%7D\&snip_name\[]=example.md\&snip\[]=%25%25+example.md%0A%0A%23+I%27m+a+markdown+file.%0A%0AAnd+I+can+do+%2Aemphasis%2A.%0A%23%23+With+sub-headers%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AUse+3+dashes+for+an+em-dash.+Use+2+dashes+for+%0Aranges+%28ex.%2C+%22it%27s+all+in+chapters+12--14%22%29.+%0AThree+dots+...+will+be+converted+to+an+ellipsis+%0A%28provided+you+include+the+smartEllipses+option+%0Ain+your+preamble%29.+Unicode+is+supported.\&main_document=main.tex)

Ví dụ này tạo ra kết quả sau:

![Hình minh họa hiển thị đầu ra từ gói markdown](/files/859cc0038d96ac63e06bfd8704d660fc52050b08)

## Sử dụng markdown nội tuyến

Hãy sử dụng `markdown` môi trường:

```latex
\begin{markdown}
...markdown của bạn
được đặt ở đây...
\end{markdown}
```

để viết markdown nội tuyến, như ví dụ tiếp theo minh họa:

```latex
\documentclass{article}
\usepackage[hashEnumerators,smartEllipses]{markdown}
\begin{document}

Sử dụng markdown nội tuyến:

\begin{markdown}
Một tiêu đề h1
============

Các đoạn văn được ngăn cách bằng một dòng trống.

Đoạn văn thứ 2. *Nghiêng*, **đậm**, và `monospace`. Danh sách gạch đầu dòng
trông như sau:

* mục này
* mục kia
* mục còn lại

> Trích dẫn khối được
> viết như thế này.
>
> Chúng có thể trải dài qua nhiều đoạn,
> nếu bạn muốn.

Một tiêu đề h2
------------

Đây là một danh sách có đánh số (dùng tùy chọn `hashEnumerators` nếu bạn muốn dùng dấu thăng):

#. mục đầu tiên
#. mục thứ hai
#. mục thứ ba

\end{markdown}
\end{document}
```

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%2CsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0AUsing+inline+markdown%3A%0A%0A%5Cbegin%7Bmarkdown%7D%0AAn+h1+header%0A%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%0A%0AParagraphs+are+separated+by+a+blank+line.+%0A%0A2nd+paragraph.+%2AItalic%2A%2C+%2A%2Abold%2A%2A%2C+and+%60monospace%60.+Itemized+lists%0Alook+like%3A%0A%0A%2A+this+one%0A%2A+that+one%0A%2A+the+other+one%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AAn+h2+header%0A------------%0A%0AHere%27s+a+numbered+list+%28use+%60hashEnumerators%60+option+if+you+want+to+use+hashes%29%3A%0A%0A%23.+first+item%0A%23.+second+item%0A%23.+third+item%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Ví dụ về markdown nội tuyến được dàn trang trong Overleaf](/files/c1a169b3dd5d40b64cc5f0d039ada77485b431e1)

## Các tính năng và tùy chọn của gói Markdown

Ở đây chúng ta sẽ khám phá một vài [tính năng và tùy chọn](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) được cung cấp bởi `markdown` gói.

### Chèn mã vào markdown

Có hai cơ chế để hiển thị các đoạn mã (khối mã) trong markdown:

* thụt lề mỗi dòng của khối ít nhất bằng bốn dấu cách hoặc một tab, hoặc
* sử dụng cái gọi là [khối mã có rào chắn](#using-fenced-code-blocks)

#### Sử dụng thụt lề để hiển thị khối mã

Ví dụ sau dùng 4 hoặc nhiều hơn ký tự khoảng trắng ở đầu mỗi dòng mã—một số dòng dùng 6, 8 hoặc 10 ký tự khoảng trắng tùy theo mức thụt lề cần thiết:

```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
Dưới đây là một số đoạn mã được thụt vào ít nhất 4 ký tự khoảng trắng.
\vspace{6mm}

\begin{markdown}

Đây là một đoạn mã C:

    /* Để tôi lặp lại ... */

    int i;
    for(i=0; i<10; i++)
    {
      do-something(i)
    }

Đây là một số HTML:

    <html>
      <head>
        <title>Tiêu đề trang</title>
      </head>
      <body>
        <h1>Đây là một tiêu đề</h1>
          <p>Đây là một đoạn văn.</p>
      </body>
    </html>

\end{markdown}
\end{document}
```

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+code+snippets\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0AHere+are+some+code+fragments+indented+by+at+least+4+space+characters.%0A%5Cvspace%7B6mm%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0A%0AHere+is+a+fragment+of+C%3A%0A%0A++++%2F%2A+Let+me+iterate+...+%2A%2F%0A%0A++++int+i%3B%0A++++for%28i%3D0%3B+i%3C10%3B+i%2B%2B%29%0A++++%7B%0A++++++do-something%28i%29%0A++++%7D%0A%0AHere+is+some+HTML%3A%0A%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Ví dụ dàn trang mã qua markdown](/files/af5012a7063604d6aef63373da3322babab264e8)

#### Sử dụng các khối mã có rào chắn

Một khối mã có rào chắn được tạo bằng cách viết một trong hai

* ba dấu backtick (` ``` `), hoặc
* ba dấu ngã (`~~~`)

trên các dòng trước và sau khối mã. Dùng cách này bạn không cần thụt lề dòng nào nhưng bạn cần dùng tùy chọn `fencedCode` trong phần tiền đề:

```latex
\usepackage[fencedCode]{markdown}
```

Đây là một ví dụ tạo khối mã có rào chắn bằng 3 dấu backtick (` ``` `):

````latex
\documentclass{article}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

```
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

```
    <html>
      <head>
        <title>Tiêu đề trang</title>
      </head>
      <body>
        <h1>Đây là một tiêu đề</h1>
          <p>Đây là một đoạn văn.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Sử dụng khối mã có rào chắn với gói LaTeX markdown](/files/5437b304f3e785fa66804730052533d10daa4883)

#### Tô sáng cú pháp

Các khối mã có rào chắn hỗ trợ tô sáng cú pháp bằng cách đặt tên ngôn ngữ sau bộ backtick đầu tiên (`` ` ``). Ví dụ, khối sau được nhận diện là Javascript bằng cách viết bộ backtick đầu tiên là ` ``` js `:

````latex
``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```
````

Đối với LaTeX, gói `minted` có thể được dùng để tô sáng cú pháp, như trong ví dụ tiếp theo có chứa một ít Javascript (` ``` js `) và HTML (` ``` html `):

````latex
\documentclass{article}
\usepackage{minted}
\usepackage[fencedCode]{markdown}
\begin{document}
\begin{markdown}

``` js
if (a > 3) {
    moveShip(5 * gravity, DOWN);
}
```

``` html
    <html>
      <head>
        <title>Tiêu đề trang</title>
      </head>
      <body>
        <h1>Đây là một tiêu đề</h1>
          <p>Đây là một đoạn văn.</p>
      </body>
    </html>
```
\end{markdown}
\end{document}
````

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bminted%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60+js%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60+html%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Tô sáng cú pháp với minted và markdown](/files/b50546b0a50fa4f2b84b7fe173cd6d71393a1066)

### Danh sách

Các ví dụ trước [minh họa việc tạo danh sách không thứ tự](#using-inline-markdown) trong markdown bằng cách dùng `*` ký tự. Danh sách có thứ tự có thể được tạo bằng cách dùng `#` ký tự nếu `hashEnumerators` tùy chọn đã được chỉ định:

```latex
\usepackage[hashEnumerators]{markdown}
```

Cũng có thể tạo danh sách lồng nhau, như ví dụ tiếp theo minh họa:

```latex
\documentclass{article}
\usepackage[hashEnumerators]{markdown}
\begin{document}
\begin{markdown}
Đây là một danh sách đánh số có chứa một danh sách lồng nhau:

#. Trước hết, lấy những nguyên liệu này:

      * cà rốt
      * cần tây
      * đậu lăng

#. Đun sôi một ít nước.

#. Đổ tất cả vào nồi và làm theo thuật toán này:

        tìm thìa gỗ
        mở nắp nồi
        khuấy
        đậy nắp nồi
        cân bằng thìa gỗ một cách chênh vênh trên tay cầm nồi
        đợi 10 phút
        quay lại bước đầu tiên (hoặc tắt bếp khi xong)

    Đừng chạm vào thìa gỗ kẻo nó sẽ rơi.
\end{markdown}
\end{document}
```

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+nested+list+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AHere+is+a+numbered+list+that+contains+a+nested+list%3A%0A%0A%23.+First%2C+get+these+ingredients%3A%0A%0A++++++%2A+carrots%0A++++++%2A+celery%0A++++++%2A+lentils%0A%0A%23.+Boil+some+water.%0A%0A%23.+Dump+everything+in+the+pot+and+follow+this+algorithm%3A%0A%0A++++++++find+wooden+spoon%0A++++++++uncover+pot%0A++++++++stir%0A++++++++cover+pot%0A++++++++balance+wooden+spoon+precariously+on+pot+handle%0A++++++++wait+10+minutes%0A++++++++goto+first+step+%28or+shut+off+burner+when+done%29%0A%0A++++Do+not+bump+wooden+spoon+or+it+will+fall.%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Tạo danh sách được đánh số bằng gói markdown của LaTeX](/files/54da040b418227a1b588533ee6e4a9be4e27d6a5)

### Chèn LaTeX vào trong markdown

Nếu bạn bật `hybrid` tùy chọn, bạn có thể trộn mã LaTeX trong Markdown!

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
\begin{document}

\begin{markdown}
Các phương trình toán học nội dòng có thể được tạo như sau: $\omega = d\phi / dt$.
Toán học hiển thị có thể được viết như sau:

\begin{equation}
I = \int \rho R^{2} dV
\end{equation}

\end{markdown}
\end{document}
```

[Mở ví dụ này trong Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+LaTeX+code+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0AInline+math+equations+can+be+created+like+this%3A+%24%5Comega+%3D+d%5Cphi+%2F+dt%24.+%0ADisplay+math+can+be+written+as%3A%0A%0A%5Cbegin%7Bequation%7D%0AI+%3D+%5Cint+%5Crho+R%5E%7B2%7D+dV%0A%5Cend%7Bequation%7D%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Sử dụng mã LaTeX trong markdown](/files/71f83215b08936fe1ebc2adea40fed34161dc7d2)

### Chèn hình ảnh

* **Lưu ý**: Ví dụ tiếp theo sử dụng một tệp đồ họa (`example-image.pdf`) được cung cấp bởi `mwe` gói. Các tệp đồ họa này được phân phối bởi TeX Live và vì thế được lưu trữ trên máy chủ của Overleaf, khiến chúng có sẵn làm hình giữ chỗ, như ví dụ dưới đây.

Có thể chèn hình ảnh vào markdown bằng cách viết đánh dấu theo định dạng sau:

```latex
![alt-text](file-name "image caption")
```

Hy vọng rằng, các tên tham số `văn bản thay thế`, `tên tệp` và `"chú thích hình ảnh"` mô tả chúng làm gì. Đây là một ví dụ để minh họa:

```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Gói mwe cung cấp các ảnh mẫu. Việc tải nó là
% không cần thiết vì những ảnh đó nằm trong đường dẫn tìm kiếm của LaTeX.
% Ở đây, chúng tôi tải nó để rõ ràng hơn trong ví dụ này.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Ví dụ này cho thấy cách nhập một tệp đồ họa. Ở đây chúng ta đang sử dụng một
hình ảnh mẫu do gói `mwe` cung cấp.

% Dùng \setkeys{Gin} nếu bạn cần thay đổi kích thước hiển thị của hình ảnh

\setkeys{Gin}{width=.5\linewidth}
![Đây là văn bản thay thế để mô tả hình ảnh của tôi.](example-image.jpg "Một hình ảnh mẫu do gói \texttt{mwe} cung cấp.")
\end{markdown}
\end{document}
```

[Mở ví dụ này trên Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)

Ví dụ này tạo ra kết quả sau:

![Minh họa cách nhập hình ảnh trong markdown](/files/d5af8565aae393bba6ef5cf02f7eb8e78a1e4055)

#### Lưu ý về chiều rộng của hình ảnh

Giống như hầu hết các gói, `markdown` gói này tải các gói khác, bao gồm [`keyval`](https://ctan.org/pkg/keyval?lang=en) và [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), để tận dụng các lệnh và tính năng mà chúng cung cấp. Ở đây, chiều rộng của hình ảnh được đặt bằng `\setkeys` lệnh, được cung cấp bởi `keyvals`. `Gin` là một "họ" các khóa được định nghĩa bởi `graphicx` gói.

* **Lưu ý**: Vì một lệnh LaTeX, ở đây `\setkeys`, được sử dụng *trong* trang `markdown` môi trường,  `hybrid` tùy chọn của gói markdown là bắt buộc.

## Đọc thêm

Overleaf đã xuất bản các bài viết khác về việc sử dụng markdown:

* [Cách viết Markdown trên Overleaf](/latex/vi/bai-viet-chuyen-sau/30-how-to-write-in-markdown-on-overleaf.md)
* [Markdown vào LaTeX với phong cách](/latex/vi/bai-viet-chuyen-sau/32-markdown-into-latex-with-style.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/vi/co-so-tri-thuc/166-writing-markdown-in-latex-documents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
