Markdown – Viết Tài Liệu Chưa Bao Giờ Dễ Dàng Thế

Thú thật với bạn, trong một thời gian dài, tôi đã từng nghĩ rằng tất cả những tệp tin mà tôi nhìn thấy trên các source code của GitHub với đuôi mở rộng .md là một kiểu tệp tin gì kinh khủng lắm và chỉ dành cho các lập trình viên cao cấp mới sử dụng được @@. Điều đó đã hoàn toàn thay đổi gần đây sau khi chính tôi sử dụng Markdown, và nó đã nhanh chóng trở thành một trong những công cụ quan trọng nhất của tôi trong công việc hằng ngày.

Bạn chỉ cần thêm một vài kí tự đặc biệt quan trọng và những thứ bạn đã và đang viết, cùng với những ứng dụng tương hỗ hay phần lan rộng ra của Trình duyệt, thì những văn bản của tôi đã hoàn toàn có thể quy đổi thành đủ mọi kiểu định dạng như ODT, email, PDF, …

Markdown là gì?

Cách đễ nhất để vấn đáp thắc mắc này, hay dùng định nghĩa được viết ra từ Wikipedia

Markdown là một ngôn ngữ đánh dấu đơn giản với cú pháp được định dạng bằng cách dùng văn bản thô

Điều đó có nghĩa là bằng việc chỉ sử dụng một vài kí tự trong văn bản của bạn, thì Markdown sẽ giúp bạn tạo ra một văn bản có cấu trúc rõ ràng. Nếu như bình thường, khi bạn viết các ghi chú ở dạng chỉ toàn chữ(notepad là ví dụ điển hình), thì sẽ chẳng có cách nào để xác định phần văn bản nào là in đậm hay in nghiêng. Trong văn bản thông thường, bạn hoàn toàn có thể viết một đường link như https://theuselessweb.com/ một lần, sau đó vì lười bạn viết còn thành theuselessweb.com, sau đó lại truy cập vào trang web(theuselessweb.com). Bạn thấy không, có thể với cách viết này(của một số người), thì diều đơn giản mà mọi người đều có thể nhận ra chính là sự thiếu nhất quán trong đó.

Nhưng nếu như bạn viết tài liệu theo đúng pháp luật mà Markdown đề ra, thì văn bản của bạn sẽ có một sự đồng điệu nhất định. Máy tính thì lại rất thích sự đồng nhất vì nguyên do nó được cho phép chúng tuân theo những thông tư rõ ràng mà không còn phải lo ngại về những trường hợp ngoại lệ .
Ở bài viết này, mình sẽ không đi vào hướng dẫn cụ thể về cách sử dụng Markdown, vì tôi tin rằng bạn trọn vẹn hoàn toàn có thể thuần thục nó chỉ trong 15 p và với vài lần thử viết, thì việc sử dụng Markdown chỉ là trò con muỗi. Vì thế ở bài viết này hãy cùng tìm hiểu và khám phá một vài góc nhìn khác của Markdown và lấy cho mình chút động lực để dùng nó trong tương lai nhé .

Markdown so sánh với các ngôn ngữ đánh đấu văn bản khác (Markup languages)

Markdown chỉ là một trong vô vàn những ngôn từ lưu lại văn bản. Sự thật là cái tên ” Markdown ” chính là một phép chơi chữ của từ ” Markup ”
Mardown được sử dụng để xuất văn bản thô trên trình duyệt nhưng những ngôn từ ghi lại khác lại hoàn toàn có thể tiếp xúc trực tiếp với máy tính. Đơn cử như XML là một ngôn từ lưu lại văn bản mà cả con người lẫn máy móc hoàn toàn có thể đọc được
Một ngôn từ ghi lại văn bản khác mà mọi người chắc rằng ai học CNTT cũng biết vì độ nổi tiếng của nó, chính là HTML. Một ngôn từ lưu lại được định nghĩa là một công cụ dùng để :

” Xử lý, định nghĩa và trình diễn văn bản. Ngôn ngữ sẽ chỉ định code cho việc định dạng, cả về cách sắp xếp và phong thái, trong file văn bản đó. Phần code được sử dụng cho việc định dạng sẽ được gọi là những nhãn ( tag ) ” – Webopedia

Điều này có nghĩa là những nhãn cho việc định dạng này được vận dụng một cách trực tiếp trong file văn bản, thay vì được định nghĩa trong một file riêng không liên quan gì đến nhau như là CSS .
Markdown không mang trong mình thiên chức ” Kẻ huỷ diệt HTML ” hay gì, mà mục tiêu của nó chính là làm đơn giản hoá việc lưu lại văn bản và tăng cường vận tốc viết lách một cách đáng kể

Lợi ích không ngờ của Markdown

Rất nhiều người viết tài liệu kĩ thuật nhận ra rất nhiều quyền lợi khi sử dụng Markdown khi viết tài liệu của họ. Một vài quyền lợi trong đó hoàn toàn có thể kể đến như

  • Markdown cung cấp ngữ nghĩa cho nội dung theo một cách tương đối đơn giản
  • Bạn có thể viết những nội dung được định dạng phong phú một cách nhanh chóng(So sánh với việc viết trực tiếp bằng HTML tags)
  • Bạn có thể đọc Markdown dễ dàng dưới dạng văn bản thô trước khi được xuất ra HTML
  • Nó không hề cản trở luồng công việc của bạn bằng việc sử dụng chuột hay biểu tượng để click
  • Nó không phụ thuộc nền tảng nên nội dung của bạn sẽ không cố định ở định dạng của trình sửa văn bản bạn đang dùng

Markdown cũng rất nhẹ, bạn sẽ chẳng cần phải học cả tiếng đồng hồ đeo tay để hoàn toàn có thể mở màn với nó
Rất nhiều tài liệu loại sản phẩm được viết dưới dạng Markdown cũng bởi tính linh động của nó, và nó hoàn toàn có thể quy đổi giữa những nền tảng. Ví dụ, bạn hoàn toàn có thể viết Markdown ở một trình soạn thảo như VSCode, hay thậm chí còn cả nền tảng kiểm soát-phiên bản như GitHub vì nó cũng tương hỗ Markdown ( file README.md bạn hay thấy ở những source code )

Bạn nên sử dụng Markdown khi nào?

Có một câu hỏi mà bạn sẽ đặt ra ( nếu chưa thì tôi hỏi hộ bạn luôn ^ ^ ), là tại sao tôi phải sử dụng Markdown thay vì một trình chỉnh sửa WYSIWYG ( What you see is what you get – Thứ bạn thấy chính là thứ bạn nhận được ), thứ mà đã trở thành tiêu chuẩn và Open rất nhiều lúc bấy giờ ?

Những trình chỉnh sửa WYSIWYG này(đơn cử như Word) yêu cầu bạn phải ấn vào các phím trên màn hình nhằm đạt được kiểu định dạng mà bạn muốn, và bị giới hạn bởi thiết kế của người sáng tạo phần mềm. Và bạn cũng có thể phải sử dụng cái trình chỉnh sửa đó mọi lúc, nếu như không muốn việc xem nội dung của nó trở thành bất khả thi

Một số bạn sẽ có mối lo lắng rằng Markdown không có đủ những tính năng mà tương thích với nhu yếu và nếu như họ lan rộng ra nó thì nội dụng sẽ không hề tái sử dụng được. Markdown hoàn toàn có thể được lan rộng ra với những tính năng nâng cao. Điều đó có nghĩa là một ai đó hoàn toàn có thể tạo ra một phiên bản khác của Markdown để tương thích với nhu yếu của họ. Nói theo một cách khác, nếu bạn lan rộng ra nó, thì phiên bản Markdown ưa thích của bạn có lẽ rằng sẽ không còn tương thích cho những nền tảng khác
Hãy hỏi bản thân rằng liệu bạn muốn có một kho nội dung phức tạp với cả nghìn trang mà hoàn toàn có thể tái sử dụng xuyên suốt những nền tảng như là web, kho kiến thức và kỹ năng cá thể và để in ?
Trong trường hợp này, Markdown có lẽ rằng không dành cho bạn
Nhưng nếu bạn muốn nhanh gọn tạo ra một tài liệu đơn thuần với định dạng phong phú và đa dạng, thì Markdown sẽ hoàn toàn có thể dành cho bạn .

Một vài “hương vị” của Markdown cho bạn tham khảo

Mặc dù có rất nhiều phiên bản của Markdown, chỉ có một vài ví dụ điển hình nổi bật trong số đó sẽ được nhắc đến ở đây

  • CommonMark được tạo ra vào năm 2012 như một nỗ lực trong việc tạo ra một chuẩn mực cho Markdown. Gruber không hề cổ vũ cho khái niệm chuẩn mực, vì anh ấy nghĩ rằng những cú pháp chuẩn mực đó chắc chắn không thể nào có thể thoả mãn những người dùng với các nhu cầu khác nhau
  • GitHub-Flavored Markdown, dựa vào Commonmark, đã thêm một vài tính năng như bảng, gạch ngang các từ, danh sách công việc, và các liên kết tự động

Markdown trên Github

  • MultiMarkdown(MMD) thêm vào bảng, chú thích, trích dẫn và các tính năng khác. Nó bao gồm các công cụ để chuyển đổi Markdown thành các định dạng khác như HTML, PDF và OpenDocument

Các trình chỉnh sửa và công cụ liên quan đến Markdown

Trình chỉnh sửa

  • Typora là một trình trỉnh sửa WYSIWYG mà dùng GitHub Flavored Markdown, có thể tải về trên Mac, Windows, và Linux

    Cả cái blog này đang được viết trên đây và sẽ được convert thành html để up lên trang web mà bạn đang đọc

    Giao diện Typora trên Window

  • MacDown, Dillinger, phân chia màn hình để cho bạn thấy được một bản xem trước của nội dung đã được định dạng trong lúc bạn chỉnh sửa Markdown trực tiếp

Công cụ

  • HashifyMarkdown Dingus đều là những công cụ giúp bạn thử nghiệm với Markdown: Nhập tài liệu bằng Markdown và quan sát kết quả được định dạng xuất ra được ngay lập tức
  • Babelmark là một công cụ dùng để so sánh cú pháp và đầu ra với các cách triển khai khác nhau. Bạn có thể nhập vào một phần Markdown và quan sát xem nó sẽ được biểu diễn thế nào với mỗi cách triển khai

Nếu đã chuẩn bị sẵn sàng thì bạn nên khởi đầu từ đâu ?
Cú pháp cơ bản đã có bài dịch sẵn ở đây để những bạn hoàn toàn có thể tìm hiểu thêm. Mình khuyên là nên dùng Typora để có được trái nghiệm viết tốt nhất nha. Bắt tay vào và thao tác nào ^ ^

Tham khảo

[ 1 ] An introduction to Markdown | Opensource. com

[2] Markdown – Wikipedia tiếng Việt

[ 3 ] Pros and Cons of Using Markdown for Technical Writing | Hacker Noon
[ 4 ] Why You Should and Should Not Use Markdown | by Peter Conrad | Medium

ĐÁNH GIÁ post
Bài viết liên quan

Tư vấn miễn phí (24/7) 094 179 2255