> 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/bai-viet-chuyen-sau/32-markdown-into-latex-with-style.md).

# Chuyển Markdown sang LaTeX một cách phong cách

**Cập nhật sau khi xuất bản** (13 tháng 5, 2017): Chúng tôi biết ơn Vít Novotný, tác giả/người bảo trì của `markdown` gói, vì đã viết thư cho chúng tôi với một số phản hồi hữu ích liên quan đến bài viết gốc. Chúng tôi rất vui được công bố phiên bản cập nhật này, phiên bản đã ghi nhận và bao gồm những lời khuyên và gợi ý của anh ấy.

### Giới thiệu

Cách đây một thời gian, chúng tôi đã vui mừng trước việc phát hành [`gói markdown`](http://www.ctan.org/pkg/markdown) giúp có thể viết cú pháp markdown trong các tài liệu LaTeX—và đã ăn mừng điều đó bằng một bài viết có tên [Cách viết bằng Markdown trên Overleaf](/latex/vi/bai-viet-chuyen-sau/30-how-to-write-in-markdown-on-overleaf.md) mà mục đích là để minh họa một số cú pháp được hỗ trợ.

**Nhớ**: Bạn sẽ cần biên dịch các tệp `.tex` của mình với tùy chọn `--shell-escape` để nó hoạt động trên các bản cài đặt LaTeX cục bộ—Overleaf làm điều này cho bạn (tự động). Hãy lưu ý rằng hầu hết các cổng nộp bài cho tạp chí không bật `--shell-escape`—trừ khi bạn chỉ được phép tải lên tệp PDF đầu ra của bản thảo, các tệp LaTeX chứa markdown của bạn có thể không biên dịch thành công khi được hệ thống nộp bài của nhà xuất bản xử lý.

Một trong những ý tưởng được gợi ý trong [bài viết trước](/latex/vi/bai-viet-chuyen-sau/30-how-to-write-in-markdown-on-overleaf.md) Điều đó [bài viết trước](/latex/vi/bai-viet-chuyen-sau/30-how-to-write-in-markdown-on-overleaf.md) đã đưa ra một số ví dụ về việc dùng markdown trong [các bài thuyết trình Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) và [áp phích](https://www.overleaf.com/read/jtbgmmgqrqmh): hôm nay chúng ta sẽ xem thêm nhiều khả năng tạo kiểu vui nhộn và thú vị hơn nữa!

### Sử dụng markdown trong các mẫu LaTeX có kiểu dáng

Ngoài các ví dụ ở trên, bạn có thể dùng markdown trong hầu như mọi mẫu. Dưới đây là một vài ví dụ nhanh:

* Tính năng [sách màu cam Legrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) mẫu
* Tính năng [tờ phát tay lấy cảm hứng từ Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) mẫu
* Tệp này [mẫu bài viết rất đẹp](https://www.overleaf.com/read/xfsrpsmdtqvt) bởi Thiago

Bạn có thể nhận thấy rằng hai trong số này là mẫu bài viết và một là mẫu sách. Gói [`gói markdown`](http://www.ctan.org/pkg/markdown) phát hiện xem `\chapter` lệnh có sẵn để dùng trong một tài liệu LaTeX cụ thể và sẽ làm cho tiêu đề cấp một `markdown` dòng hiển thị thành `\chapter` hoặc `\section` phù hợp.

### Tờ phát tay thật nhanh: markdown + pocketmod

Từ khi tôi lần đầu biết đến markdown, nó đã khiến tôi thấy đây là một cách nhanh chóng và tiện lợi để ghi chú: nó phản ánh cách tôi có thể nguệch ngoạc ghi chú trên những mẩu giấy hay giấy nhớ—đặc biệt là với cú pháp danh sách gạch đầu dòng và đánh số. Khi tôi lần đầu tạo ra [mẫu PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) vào năm 2015, tôi khao khát một cách viết markdown trong LaTeX để tôi có thể tạo các PocketMod *với* markdown vì nó có vẻ… phù hợp. Ghi chú bằng cú pháp đơn giản trên những cuốn sổ gấp nhỏ, nhưng với kiểu chữ đẹp—một số người gọi PocketMod là "zine" vì chúng là những cuốn sách nhỏ 8 trang mà bạn có thể làm từ một tờ giấy A4 duy nhất.

Và quả thật là có thể! Điều này giúp việc nhanh chóng tạo ra một [sổ tay lập kế hoạch tuần mini](https://www.overleaf.com/read/zfzcxygqwqsq) hoặc một [sách kể chuyện bằng tranh](https://www.overleaf.com/read/rppnsfgnrhsf). Đúng vậy, con gái tôi đã rất thích thú khi thấy một cuốn sách truyện được làm từ chính những bức vẽ của bé… à thì, được đúng 10 phút! Hàm [`gói markdown`](http://www.ctan.org/pkg/markdown) cho phép bạn tùy chỉnh cách mỗi cú pháp markdown được hiển thị thành LaTeX, vì vậy tôi đã định nghĩa lại cú pháp chuẩn `![](img_file "caption")` để đặt chú thích bên dưới tệp ảnh (không có tiền tố "Figure" hay đánh số), rồi chèn một ngắt trang. Điều này làm cho việc tạo sách tranh còn dễ hơn nữa. Đây là một video cho thấy cách gấp cuốn sách nhỏ:

{% embed url="<https://www.youtube.com/embed/IAb31rIeGZo>" %}

### Sổ tay công thức đơn giản

Khi nghĩ kỹ, một công thức được cấu thành từ các danh sách: danh sách nguyên liệu, danh sách các bước chuẩn bị hoặc nấu nướng, và có lẽ là một danh sách ghi chú (thời gian nấu, khẩu phần, v.v.). Vì vậy, thay vì viết thế này:

```latex
\begin{enumerate}
\item Trước tiên làm điều này
\item Sau đó làm điều kia
...
\end{enumerate}
```

Tôi chắc chắn sẽ thích hơn nếu có thể viết thế này:

```
#. Trước tiên làm điều này
#. Sau đó làm điều kia
```

Và tương tự đối với phần nguyên liệu:

```
- 2 quả trứng
- nhúm muối
```

Vì vậy, để dễ dàng tạo ra một công thức nhanh, chúng ta có thể viết thế này:

```
# Trứng bác

Thời gian nấu
: 5 phút

Khẩu phần
: 1

## Nguyên liệu
- 4 quả trứng
- 1 thìa cà phê bơ
- 1/4 cốc sữa
- muối, tiêu (tùy khẩu vị)

## Hướng dẫn

#. Đánh trứng, sữa...
#. Đun bơ trong chảo...
#. ...
```

Ừm, có vẻ hứa hẹn đấy. Một vài người trong chúng tôi ở Overleaf (và gia đình của chúng tôi) đã đóng góp những công thức nhanh yêu thích của mình (lý tưởng cho những người mới nấu ăn) và tôi đã chắp bút (xin lỗi vì cách chơi chữ) một [mẫu công thức nhanh](https://www.overleaf.com/read/gscqdhnwzsfg) mà bạn có thể viết bằng markdown *và* để biến thành một cuốn sổ nhỏ.

[![A recipe booklet produced on Overleaf using markdown](/files/87d33fbd0b40a6055d040a0e5d52220112fb8744)](https://www.overleaf.com/read/gscqdhnwzsfg)

Giờ đến một chút thú vị khác. Bên trong thì đây vẫn là LaTeX nên chúng ta có thể tiếp tục tạo kiểu cho các thành phần khác nhau—tiêu đề mục, danh sách gạch đầu dòng, phông chữ, v.v.—bằng bộ công cụ quen thuộc của LaTeX. Đến lúc này thì tôi hơi quá đà và nghĩ ra *ba* “chủ đề” cho lớp `simple-recipe` !

### Phần thưởng 1: Một số lưu ý khi dùng gói markdown

* SyncTeX sẽ không hoạt động hoàn toàn. Trên Overleaf, điều này có nghĩa là các thao tác "vị trí trong bản xem trước" và "nhấp vào bản xem trước để nhảy tới mã nguồn" sẽ không hoạt động trong `markdown` các vùng.
* `\\` mất đi ý nghĩa thông thường của nó: quy tắc thông thường "hai dấu cách theo sau bởi một dòng mới" `markdown` mẹo này không hoạt động ở đây vì các khoảng trắng cuối dòng sẽ bị bộ phân tích Lua loại bỏ, như đã được nêu trong [`markdown` tài liệu gói](http://texdoc.net/pkg/markdown). `\newline` tuy nhiên sẽ hoạt động.
* Hãy cẩn thận với nhiều ký tự gạch dưới trên cùng một dòng—điều này có thể là vấn đề nếu:

  * bạn đang làm việc với rất nhiều chỉ số dưới trong các phương trình của mình (mẹo: hãy thoát ra khỏi môi trường `markdown` trong những trường hợp như vậy);
  * bạn thích dùng dấu gạch dưới trong các khóa BibTeX của mình.

  Bạn có thể đặt `underscores=false` với các `gói markdown` tệp mới nhất để cho các dấu gạch dưới dùng làm chỉ số dưới hoạt động, nhưng nó vẫn sẽ không hoạt động với dấu gạch dưới trong các khóa BibTeX.

  **Cập nhật** (13 tháng 5, 2017): Dấu gạch dưới trong các khóa BibTeX sẽ hoạt động với `markdown` từ phiên bản v2.5.2 trở đi—cảm ơn Vít!
* Bạn sẽ gặp chút khó khăn khi hiển thị một ký tự thăng (#) nguyên văn vì ngay cả `\#` cũng sẽ không hoạt động! Tôi thường định nghĩa một lệnh mới và dùng lệnh đó thay thế.

### Phần thưởng 2: Các tính năng mới trong gói markdown đã cập nhật

`markdown` v2.4 trở lên đã thêm hỗ trợ cho một số cú pháp rất hay:

* **Cú pháp chú thích cuối trang chèn trực tiếp**: `...^[đây là chú thích cuối trang]` (yêu cầu tùy chọn `inlineFootnotes` )
* **Trích dẫn:**`[@smith1990]` (yêu cầu tùy chọn `trích dẫn` tùy chọn; cũng hãy cẩn thận với dấu gạch dưới trong các khóa BibTeX của bạn!)
* **Mã khối có khung**: Bạn có thể dùng dấu ngã `~` hoặc dấu backtick `` ` `` làm khung.

```
~~~~
int main() {
  cout << "Hello world!";
  return 0;
}

~~~~
```

Nếu bạn muốn dùng những tính năng mới này, hãy nhớ tải lên các phiên bản đã cập nhật của `markdown.lua`, `markdown.tex` và `markdown.sty` vào dự án của bạn—hoặc bạn có thể chỉ cần tạo một dự án mới từ [mẫu này](https://www.overleaf.com/read/whdrnpcpnwrm).


---

# 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/bai-viet-chuyen-sau/32-markdown-into-latex-with-style.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.