Khi dịch tài liệu kỹ thuật (Markdown), cần xử lý các khối mã và Front Matter như thế nào?

Quy trình hiện tại trích xuất nội dung để dịch theo cấu trúc Markdown. Mã nội tuyến có thể được trích xuất cùng văn bản xung quanh, và chú thích trong khối mã cũng có thể được đưa vào bản dịch. Sau khi dịch, hãy kiểm tra các ký hiệu như ``` và ` cùng cú pháp và logic của ví dụ Python và JS. Đừng giả định rằng mọi vùng mã đều sẽ được bỏ qua.

Đối với cấu hình YAML ở đầu tài liệu (Front Matter), thường gặp trong các blog tĩnh như Jekyll/Hugo, quy trình trích xuất hiện tại không xử lý giá trị của các trường như `title` và `description` thành văn bản riêng để dịch. Hãy kiểm tra siêu dữ liệu thủ công sau khi dịch và giữ nguyên các tham số dựng như `date:` và `slug:`.

Sau khi dịch bảng Markdown, thay đổi về độ dài văn bản có thể gây khác biệt trong việc căn chỉnh cột ở mã nguồn. Hãy kiểm tra ký tự `|`, hàng phân cách và nội dung ô, rồi chỉnh lại mã nguồn bảng thủ công nếu cần.