Chuyển đổi từ CSV sang Markdown

Tệp README, phần mô tả pull request và các trang tài liệu đều hiển thị bảng Markdown rất đẹp mắt, miễn là bạn chịu khó gõ thủ công các dấu gạch đứng và dấu gạch ngang. Công cụ này đọc tệp CSV, lấy hàng đầu tiên làm tiêu đề và tạo ra bảng GitHub Flavored Markdown với dòng phân cách phù hợp. Mọi ô đều được bao quanh bởi dấu phân cách |, sẵn sàng dán vào README hoặc mô tả pull request.

Cách xây dựng bảng

  1. 1

    Dán tệp CSV

    Mặc định là mẫu ba cột; hãy thay bằng dữ liệu của bạn.

  2. 2

    Chọn ký tự phân cách

    Mặc định là dấu phẩy. Chọn tab, dấu chấm phẩy hoặc dấu gạch đứng từ danh sách cho phù hợp với dữ liệu của bạn.

  3. 3

    Dòng 1 là tiêu đề

    Dòng đầu tiên được hiển thị dưới dạng tiêu đề Markdown, tiếp theo là dòng phân cách bắt buộc `| --- | --- |`.

  4. 4

    Các hàng được lấp đầy đến độ rộng

    Nếu một hàng dữ liệu có ít ô hơn số ô trong phần tiêu đề, bộ chuyển đổi sẽ thêm các chuỗi trống để giữ hình dạng bảng luôn là hình chữ nhật.

Hiển thị, căn chỉnh và nơi nó hoạt động hoặc không hoạt động

Các bảng GitHub Flavored Markdown (GFM) được hỗ trợ rộng rãi nhưng không phải ở mọi nơi. Biết được chúng hiển thị ở đâu chính là điều tạo nên khác biệt giữa một tệp README gọn gàng và một bức tường đầy dấu gạch đứng.

Được hỗ trợ tại

  • Pull request và wiki trên GitHub, GitLab và Bitbucket
  • Hầu hết các trình tạo trang tĩnh (Docusaurus, VitePress, MkDocs Material)
  • Bản xem trước Markdown trong VS Code
  • Notion (bằng cách dán dưới dạng Markdown)

Không được hỗ trợ tại

  • CommonMark không có phần mở rộng GFM
  • Reddit (dùng tập con riêng)
  • Một số công cụ wiki cũ (DokuWiki, MoinMoin)

Căn chỉnh cột

Các bảng GFM hỗ trợ căn trái, căn giữa và căn phải thông qua dấu hai chấm trong dòng phân cách. Công cụ này tạo ra dấu phân cách --- thông thường; nếu bạn cần căn chỉnh, hãy xử lý thêm sau đó:

Cú pháp Hiệu ứng
:--- Căn trái
:---: Căn giữa
---: Căn phải

Tìm và thay dòng phân cách bằng | :--- | :---: | ---: | tương ứng với các cột bạn muốn căn chỉnh.

Thoát ký tự trong ô Markdown

  • Các dấu gạch đứng (|) bên trong một ô phải được thoát thành \\| để tránh làm ô bị tách. Công cụ không tự động thoát chúng, vì vậy hãy làm sạch dữ liệu trước nếu dữ liệu của bạn có chứa dấu gạch đứng.
  • Ký tự xuống dòng bên trong một ô sẽ làm hỏng hiển thị GFM. Hãy thay chúng bằng <br> trước khi chuyển đổi nếu bạn muốn xuống dòng mềm bên trong ô.
  • Dấu sao, dấu gạch dưới và dấu huyền ngược đều được giữ nguyên và được hiểu là dấu nhấn mạnh hoặc mã trong Markdown. Để hiển thị theo đúng nghĩa đen, hãy đặt một dấu gạch chéo ngược ở phía trước.

Câu hỏi thường gặp

Không phải mặc định: dòng phân cách chỉ là --- thông thường. Sau khi chuyển đổi, hãy thay nó bằng :---, :---: hoặc ---: để cố định cột về bên trái, giữa hoặc bên phải.

Hãy thoát chúng bằng dấu gạch chéo ngược trước khi chuyển đổi, biến | thành \|. Nếu không, trình hiển thị Markdown sẽ coi chúng là dấu phân cách cột và làm hỏng bảng.

Các bảng GFM hiển thị trên GitHub, GitLab, hầu hết các trình tạo trang tĩnh và VS Code. Chúng không hiển thị trên CommonMark thuần túy, Reddit hay một số wiki cũ không có plugin.

Có. CSV được gửi đến máy chủ của chúng tôi để trình chuyển đổi có thể tạo bảng. Dữ liệu không được lưu trữ và không được thêm vào liên kết trang.

Công cụ liên quan