Tôi có thể dùng nó cho tệp README trên GitHub không?

Có — cú pháp được hỗ trợ chính là tập con mà README thường dùng. Viết ở đây, kiểm tra phần xem trước, rồi tải tệp .md hoặc sao chép Markdown vào kho mã của bạn.

Làm sao ngắt dòng mà không tạo đoạn mới?

Kết thúc dòng bằng hai khoảng trắng hoặc một dấu gạch chéo ngược. Dòng trống bắt đầu đoạn mới; một xuống dòng đơn trong đoạn được coi là khoảng trắng, như Markdown tiêu chuẩn.

Trình soạn có lưu văn bản của tôi không?

Không. Không gì được gửi lên máy chủ và không gì được lưu trong trình duyệt; tải lại trang sẽ đưa trình soạn về mẫu. Hãy tải tệp .md để giữ lại công việc.

Vì sao thẻ HTML của tôi hiện ra dưới dạng văn bản?

HTML thô được cố ý thoát ký tự trong phần xem trước để nội dung dán vào không thể chạy script. Hãy dùng cú pháp Markdown để định dạng; nếu cần HTML tùy chỉnh, hãy thêm sau khi xuất.

Trình soạn Markdown xem trước trực tiếp - Xuất HTML

Công cụ / / Công cụ lập trình viên / Công cụ định dạng / Trình soạn Markdown

Trình soạn Markdown và xem trước

Markdown

# Project Title

A short description of what this project does and who it is for.

## Features

- Live preview while you type
- **Bold**, *italic* and ~~strikethrough~~ text
- Links like [2on](https://2on.com) and inline `code`

## Installation

```bash
npm install my-project
```

## Usage

1. Import the module
2. Call `run()` with your options
3. Read the result

| Option  | Type    | Default |
|:--------|:-------:|--------:|
| verbose | boolean | false   |
| retries | number  | 3       |

> Tip: raw HTML is shown as text in the preview.

---

Made with Markdown.

Xem trước

HTML thô trong nguồn được hiển thị dưới dạng văn bản trong phần xem trước, và các liên kết javascript: hay data: bị vô hiệu.

Cách viết Markdown

Markdown là văn bản thuần với vài quy ước dấu câu: dấu thăng cho tiêu đề, dấu sao để nhấn mạnh, dấu gạch ngang cho mục danh sách. Đó là ngôn ngữ mà README, wiki, trình theo dõi vấn đề và hầu hết ứng dụng ghi chú đều hiểu. Trình soạn này hiển thị văn bản ngay khi bạn gõ, để bạn thấy cấu trúc hình thành, và xuất HTML sạch khi hoàn tất.

Các bước

1 Gõ hoặc dán Markdown vào ô bên trái. Phần xem trước bên phải cập nhật sau mỗi lần gõ.
2 Dùng mẫu như một bảng tra nhanh: tiêu đề, đậm và nghiêng, danh sách, khối mã, bảng, trích dẫn và liên kết đều có trong đó.
3 Sao chép HTML cho CMS hay mẫu giao diện, hoặc tải tài liệu dưới dạng .md hay tệp .html độc lập.

Cú pháp trong một phút

Tiêu đề: # Tiêu đề, ## Phần, ### Mục. Nhấn mạnh: **đậm**, *nghiêng*, ~~gạch ngang~~. Danh sách: bắt đầu dòng bằng - hoặc 1.; thụt vào hai khoảng trắng để lồng nhau. Liên kết: [văn bản](https://example.com); hình ảnh: ![alt](image.png). Mã nội dòng đặt trong `dấu huyền`; khối mã được bao bởi ba dấu huyền, có thể kèm tên ngôn ngữ. Một dòng --- vẽ đường kẻ, và dòng bắt đầu bằng dấu lớn hơn là trích dẫn.

Bảng

Bảng gồm một hàng tiêu đề, một hàng phân cách và các hàng dữ liệu, các ô ngăn bởi dấu gạch đứng: | Tên | Giá |. Hàng phân cách dùng dấu gạch ngang, và dấu hai chấm ở đầu nào thì căn lề theo đó — :--- trái, :---: giữa, ---: phải. Các cột không cần thẳng hàng trong nguồn; bộ hiển thị tự xử lý khoảng cách.

Bản xuất HTML chứa gì

Sao chép HTML chỉ đưa ra phần đánh dấu nội dung — đoạn văn, tiêu đề, danh sách và bảng — sẵn sàng dán vào một trang đã có kiểu dáng riêng. Tải .html gói phần đánh dấu đó vào một tài liệu hoàn chỉnh với tiêu đề lấy từ đề mục đầu tiên và một bảng kiểu nhỏ, để tệp mở dễ đọc trên mọi trình duyệt.

Vì sao HTML thô không được hiển thị

Markdown tiêu chuẩn cho HTML đi qua nguyên vẹn, tiện nhưng biến mọi tài liệu dán vào thành một cách chạy script trong trang. Phần xem trước này thay vào đó sẽ thoát ký tự: một thẻ div hay script trong nguồn hiện ra dưới dạng văn bản. Các liên kết với lược đồ javascript: và data: cũng bị vô hiệu vì lý do tương tự. Tệp bạn xuất ra cũng không chứa mã chèn.

Soạn thảo Markdown - câu hỏi thường gặp

CommonMark với các mở rộng GitHub mà mọi người thực sự dùng: bảng, gạch ngang và khối mã rào có nhãn ngôn ngữ. Chú thích cuối trang, ô đánh dấu danh sách việc và tiêu đề gạch chân (setext) không được hỗ trợ.

Công cụ định dạng dùng nhiều nhất

Mọi Thời Đại

Định Dạng JSON

Nén CSS

Định Dạng XML

Định Dạng HTML

Nén JavaScript

Mới

Định dạng YAML Thụt lề lại YAML lộn xộn, tìm lỗi kèm số dòng và đọc lại tài liệu dưới dạng JSON. Giữ nguyên chú thích, khối scalar và anchor. Chạy ngay trong trình duyệt.

Xem trang

Phổ biến hôm nay

Xem trang

Công cụ dành cho nhà phát triển liên quan

Định Dạng JSON Định dạng, nén và kiểm tra JSON ngay trên trình duyệt. Lỗi được chỉ rõ theo dòng và cột, cây gấp gọn cho thấy cấu trúc.

Định Dạng HTML Thụt lề đoạn HTML lộn xộn để đọc được, hoặc rút gọn để nó nhẹ hơn. Dùng được với cả đoạn rời, và không bao giờ viết lại mã của bạn thành thứ khác.

Nén CSS Nén CSS bằng cách bỏ chú thích và khoảng trắng, hoặc trải lại với thụt lề gọn gàng. Giữ nguyên khoảng trắng trong calc(), chuỗi và chú thích giấy phép.

Định Dạng XML Thụt lề đoạn XML lộn xộn để đọc được, hoặc rút gọn cho nhẹ. Xử lý RSS, CDATA và namespace, và không bao giờ viết lại tài liệu của bạn.

Định Dạng SQL Chia một truy vấn dài thành các dòng dễ đọc, hoặc ép lại thành một dòng. Giữ nguyên kiểu chữ từ khóa, tên trong dấu nháy và chuỗi của bạn.

Các công cụ khác bạn có thể thích

Word sang PDF Chuyển Word sang PDF miễn phí: tải lên tệp DOC, DOCX, ODT hoặc RTF và nhận bản PDF giữ đúng định dạng chỉ trong vài giây.

PDF sang Word Chuyển PDF sang Word miễn phí: tải lên tệp PDF và nhận file DOCX chỉnh sửa được trong vài giây - không đăng ký, không hình mờ.

Trình đếm từ Công cụ đếm từ miễn phí: dán văn bản để đếm từ, ký tự, câu, đoạn và xem thời gian đọc ước tính. Văn bản không rời khỏi trình duyệt.

Trình đếm ký tự Công cụ đếm ký tự miễn phí: đếm ký tự có và không có khoảng trắng, số từ, số dòng và kiểm tra giới hạn SEO cho tiêu đề, mô tả.

Trình kiểm tra mật độ từ khóa Công cụ kiểm tra mật độ từ khóa miễn phí: dán văn bản hoặc URL để xem tần suất của từng từ và cụm từ kèm tỷ lệ phần trăm.