Viết bài bằng Markdown: quy trình chuẩn cho đội nội dung

Mỗi bài viết trên website Da Vinci Academy đều bắt đầu từ một tệp .md đơn giản. Người viết không cần trình soạn thảo trực quan hay biết code: Markdown là ngôn ngữ đánh dấu tối giản, dùng vài ký tự quen thuộc để báo cho hệ thống biết đâu là tiêu đề, đâu là danh sách, đâu là trích dẫn. Phần trình bày, đường dẫn, sitemap và RSS do hệ thống tự xử lý — người viết chỉ cần tập trung vào nội dung.

Quy trình viết một bài mới

Quy trình ngắn gọn, lặp lại được cho mọi chuyên mục:

• Tạo tệp .md trong thư mục chuyên mục; tên tệp là slug của bài: chữ ASCII không dấu, số và dấu gạch ngang (ví dụ viet-markdown-voi-astro.md).
• Khai báo frontmatter: title, description, pubDate, tags và tuỳ chọn cover.
• Viết thân bài bằng cú pháp Markdown tiêu chuẩn: heading, danh sách, bảng, blockquote.
• Rà soát chính tả, kiểm tra heading đúng thứ bậc rồi gửi biên tập viên duyệt.
• Đặt draft: true nếu bài chưa phát hành; khi duyệt xong, chuyển thành false.

Frontmatter: hộ chiếu của bài viết

Frontmatter là khối YAML nằm ngay đầu tệp, giữa hai dòng ---. Đây là “hộ chiếu” của bài viết: hệ thống dựa vào đó để sắp bài vào chuyên mục, hiển thị thẻ tóm tắt, listing, RSS và meta SEO. Một mẫu tối thiểu:

---
title: "Viết bài bằng Markdown: quy trình chuẩn cho đội nội dung"
description: "Mô tả 140-160 ký tự, dùng cho meta SEO, excerpt card và RSS."
pubDate: "2026-08-29"
tags: ["Hướng dẫn", "Markdown"]
draft: false
---

Ba quy tắc cần nhớ: mọi chuỗi YAML đều đặt trong ngoặc kép — nhất là khi chứa dấu hai chấm; tags viết trên một dòng dạng mảng; pubDate theo định dạng YYYY-MM-DD.

Heading và những cú pháp hay dùng

Heading là xương sống của bài. Mỗi bài chỉ có một tiêu đề chính (do title trong frontmatter đảm nhiệm), phần thân chia theo ## rồi ###, không nhảy cóc cấp độ:

Cú pháp	Dùng khi
## Tiêu đề mục	Chia bài thành các phần lớn
- mục	Liệt kê quy trình, checklist
> trích dẫn	Nhấn mạnh nguyên tắc, câu nói đắt
**in đậm**	Làm nổi bật từ khóa quan trọng

Nguyên tắc của học viện: người viết lo nội dung và cấu trúc, hệ thống lo giao diện. Một tệp .md sạch về cấu trúc là một bài viết sạch trên website.

Khi quy trình được chuẩn hóa, cả đội cùng nói một ngôn ngữ: dễ viết, dễ duyệt, dễ phát hành — và chất lượng mỗi bài luôn như học viên mong đợi.