# Markdown sang Typst

Chuyển ghi chú Markdown thành mã nguồn Typst và mở chúng trong một dự án soạn thảo cục bộ nhanh chóng.

Markdown to Typst giữ lại sự khởi đầu dễ dàng của Markdown và trao cho bản nháp một hệ thống sắp chữ giàu biểu hiện hơn khi nó sẵn sàng. Cấu trúc phổ biến và các biểu thức toán được chuyển qua, còn kết quả vẫn là mã nguồn thuần mà bạn có thể định hình lại.

## Khi nào dùng

- ghi chú đã phát triển thành một báo cáo, tài liệu phát tay, hoặc bài báo;
- một bản nháp Markdown cần thiết kế trang mạnh mẽ hơn;
- muốn thử Typst mà không phải gõ lại nội dung.

Đừng chuyển đổi chỉ vì mới lạ. Nếu một kho chứa, trang tĩnh, hoặc cộng sự cần Markdown, tính di động của nó có thể quý hơn khả năng kiểm soát bố cục thêm.

## Chuyển đổi mã nguồn

1. Mở **Markdown to Typst**, hoặc chạy `/markdown-to-typst`.
2. Dán mã Markdown.
3. Chọn **Convert**.
4. Kiểm tra mã Typst được tạo.
5. Sao chép nó, lưu `converted.typ`, hoặc tạo một dự án Typst.

Chẳng hạn, tiêu đề Markdown, chữ đậm, danh sách đánh số, và toán phân giới bằng dấu đô la trở thành các phần tử Typst tương ứng. Quá trình chuyển đổi chạy cục bộ với Pandoc đi kèm.

## Những thứ cần chỉnh sau đó

Markdown có nhiều phương ngữ. Danh sách công việc, HTML thô, chỉ thị tùy chỉnh, phần mở rộng trích dẫn, và cú pháp plugin có thể không được chuyển qua. Typst cũng cần những lựa chọn riêng cho mẫu, kiểu thư mục tài liệu tham khảo, hình học trang, và các hàm dùng lại.

Hãy biên dịch dự án mới và kiểm tra:

- cấp bậc tiêu đề và độ lồng của danh sách;
- phương trình và các khối mã;
- liên kết và đường dẫn ảnh;
- chú thích cuối trang và trích dẫn;
- bất kỳ phần mở rộng Markdown nào không thuộc định dạng lõi.

Với một bản nộp LaTeX, hãy dùng trực tiếp [Markdown to LaTeX](/docs/tools/markdown-to-latex/). Với chiều ngược lại, hãy dùng [Typst to Markdown](/docs/tools/typst-to-markdown/). Để có một không gian làm việc Typst trắng, hãy bắt đầu với [Visual Typst Editor](/docs/tools/visual-typst-editor/) hoặc [Typst Editor](/docs/tools/typst-editor/).