Hướng dẫn Markdown cho người mới bắt đầu trên GitHub
Markdown là ngôn ngữ định dạng văn bản nhẹ giúp bạn viết đẹp hơn trên GitHub. Bài viết này sẽ hướng dẫn các cú pháp cơ bản để bạn có thể áp dụng ngay vào các dự án lập trình của mình.
Markdown là công cụ không thể thiếu đối với bất kỳ lập trình viên nào muốn làm chủ GitHub. Đây là ngôn ngữ định dạng văn bản nhẹ, cho phép bạn tạo ra các văn bản có định dạng phong phú chỉ bằng cách sử dụng văn bản thuần túy.
Bài viết này sẽ cung cấp những kiến thức cơ bản nhất về Markdown, giúp bạn dễ dàng chỉnh sửa bình luận, bài đăng và tệp tin README trên GitHub một cách chuyên nghiệp.
Markdown là gì?
Markdown được thiết kế để dễ đọc và dễ viết. Thay vì sử dụng các thẻ HTML phức tạp hay các nút bấm trên thanh công cụ, Markdown sử dụng các ký tự đặc biệt như *, # hoặc > để định dạng văn bản.
Trên GitHub, Markdown được sử dụng ở khắp mọi nơi: từ file README, các vấn đề (issues), yêu cầu kéo (pull requests) cho đến các bình luận trong mã nguồn.
Các cú pháp cơ bản
Tiêu đề (Headings)
Để tạo tiêu đề, bạn sử dụng dấu thăng (#) ở đầu dòng. Số lượng dấu thăng càng nhiều thì cấp độ tiêu đề càng nhỏ.
# Tiêu đề chính(H1)## Tiêu đề phụ(H2)### Tiêu đề nhỏ hơn(H3)
Nhấn mạnh văn bản
Bạn có thể làm nổi bật nội dung bằng cách in đậm hoặc in nghiêng.
- Để in đậm, hãy bao quanh văn bản bằng hai dấu sao:
**text**hoặc hai dấu gạch dưới:__text__. - Để in nghiêng, hãy bao quanh văn bản bằng một dấu sao:
*text*hoặc một dấu gạch dưới:_text_.
Danh sách
Markdown hỗ trợ cả danh sách có thứ tự và không thứ tự.
- Danh sách không thứ tự: Sử dụng dấu gạch ngang
-, dấu cộng+hoặc dấu chấm.. - Danh sách có thứ tự: Sử dụng số theo sau là dấu chấm, ví dụ:
1..
Mã lệnh (Code)
Đây là phần quan trọng nhất đối với các lập trình viên.
- Mã nội dòng (Inline code): Sử dụng dấu huyền ngược ` ` để bao quanh đoạn mã ngắn trong câu văn. Ví dụ:
const x = 10;. - Khối mã (Code block): Sử dụng ba dấu huyền ngược ``` để tạo một khối mã nhiều dòng. Bạn cũng có thể chỉ định ngôn ngữ lập trình sau dấu huyền đầu tiên để bật tính năng tô màu cú pháp (syntax highlighting).
Trích dẫn (Blockquotes)
Để tạo một đoạn trích dẫn, hãy sử dụng dấu lớn hơn > ở đầu dòng.
Đây là một đoạn trích dẫn. Nó rất hữu ích khi bạn muốn trích dẫn tài liệu hoặc trả lời bình luận của người khác.
Liên kết và Hình ảnh
- Liên kết:
[tên hiển thị](URL). - Hình ảnh:
.
Tại sao nên học Markdown?
Việc thành thạo Markdown không chỉ giúp giao tiếp hiệu quả hơn trên GitHub mà còn giúp tài liệu hóa dự án của bạn trở nên rõ ràng và chuyên nghiệp hơn. Hãy bắt đầu thực hành ngay hôm nay để nâng cao kỹ năng lập trình của bạn.
