2012-02-10 26 views
9

Gần đây, khi tôi sử dụng github, tôi đã gặp rất nhiều trường hợp mà tôi cần phải sử dụng markdown cho tài liệu của mình. Chẳng hạn như bất kỳ wiki và GFM (github favored markdown), *.md tệp trong cơ sở github trên jekyll, và giống như viết ở đây, v.v. Và tôi thích viết tài liệu theo cú pháp này!Có tổ chức chính thức để thảo luận hoặc phát hành cú pháp đánh dấu chuẩn không?

Nhưng tất cả các công cụ đánh dấu đều khác nhau về nhiều chi tiết: GFM không hỗ trợ cú pháp danh sách định nghĩa; maruku trong jekyll không hỗ trợ ID tạo tiêu đề tự động cho TOC; kramdown, multimarkdown ... và cứ thế. Động cơ cũng được viết bằng nhiều ngôn ngữ như ruby, PHP, Java hơn nữa.

Tôi đã tìm thấy hỗn loạn trong thế giới đánh dấu, giống như tôi phải viết CSS và JavaScript để hỗ trợ rất nhiều trình duyệt để tương thích, không tốt hơn và thậm chí tệ hơn! Vì vậy, tôi nghĩ về điều đó giống như tiêu đề của tôi, nếu có một tổ chức chính thức làm việc để làm cho cú pháp markdown là tiêu chuẩn, như W3C cho tiêu chuẩn web, thế giới trong markdown sẽ tốt hơn bao giờ hết!

Sau đó, bất kỳ ai cũng có thể gửi đề xuất cú pháp mới cho ORG và ORG có thể xem xét và xây dựng tiêu chí cú pháp chuẩn cho nhà phát triển. Vào thời điểm đó, tất cả những người dùng như chúng tôi đều có thể lựa chọn ít công cụ hơn nên sử dụng. Và chúng ta có thể viết một lần, sử dụng bất cứ nơi nào!

Vì vậy, có câu hỏi của tôi, phải không? hoặc ai đó muốn tạo nó?

+1

Chuẩn duy nhất hiện nay là hành vi của tập lệnh perl gốc được tìm thấy tại đây tại http://daringfireball.net/projects/downloads/Markdown_1.0.1.zip. Sẽ tốt hơn nếu có một tổ chức cho việc tiêu chuẩn hóa markdown. Đây là lỗi về việc triển khai markdown nhất: https: // github.com/waylan/Python-Markdown/issues/64 – yegle

+1

@yegle: Từ mọi thứ tôi đã đọc, thông số gốc "chính thức" là từ bỏ, với nhiều lỗi và sự giám sát cần được cải thiện. Có tiêu chuẩn * de facto * cho những cải tiến đó không? Một ngã ba được sử dụng bởi đa số mọi người? – endolith

+0

@edolith no. Đó là một câu trả lời buồn. Có lẽ bạn có thể xem xét GFM của github. Nó không phải là một tiêu chuẩn thực tế, nhưng ít nhất nó không chỉ sao chép tất cả mọi thứ kịch bản perl ban đầu đang làm (lỗi cũng được sao chép). – yegle

Trả lời

4

A community group đã được tạo tại W3C để tạo đặc tả cho Đánh dấu.

Chuẩn hiện tại thường được xem là this tuy nhiên có phạm vi khác với nhóm làm việc.

+1

Nghe có vẻ là một tin vui! – mytharcher

1

Tình hình đã thay đổi từ năm 2012 trở lên!

CommonMark, ban đầu được dự định được gọi là "Tiêu chuẩn đánh dấu", chính thức chỉ định cú pháp và ngữ nghĩa của ngôn ngữ cổ điển, giới thiệu một số giải thích và một số thay đổi từ văn xuôi gốc hoặc triển khai tham chiếu markdown.pl hoặc cả hai.

Đặc điểm kỹ thuật này có thể cũng là phần mở rộng tài liệu trong tương lai, nhưng rõ ràng không phải là mục tiêu chính hiện tại. Markua là một đặc tả mở khác được xây dựng dựa trên CommonMark nhưng thực hiện các phần mở rộng hữu ích ngay từ đầu - nó xuất phát từ Leanpub. Pandoc documentation mô tả một số tính năng phổ biến của Pandoc, MultiMarkdown (MMD), PHP Markdown ExtraGithub flavored Markdown (GFM), nhưng không phải Maruku, Kramdown và các tính năng phổ biến khác.

Babelmark là một dịch vụ web của John MacFarlane cố gắng mã Markdown với một số công cụ, được lưu trữ và định cấu hình bởi nhà phát triển của họ và so sánh HTML kết quả.

Thông số bổ sung là Critic Markup mô tả cú pháp để xóa, thêm, đánh dấu và nhận xét có thể được sử dụng với nhiều ngôn ngữ đánh dấu đơn giản.