Hướng dẫn sử dụng Markdown toàn tập

Hướng dẫn sử dụng Markdown toàn tập6 phút đọc

Một trong những kiến thức quan trọng mà mọi lập trình viên đều cần phải biết đó là Git.Khi làm việc với Git chắc hẳn nhiều bạn sẽ sử dụng nền tảng lưu trữ code Github phải không nào.

Nếu đúng thì bạn nên biết cách sử dụng Markdown, nó là một ngôn ngữ đánh dấu giúp bạn soạn thảo dữ liệu một cách nhanh chóng và đơn giản rất phổ biến trên thế giới.Với Markdown bạn sẽ tạo ra được phần thuyết minh cho dự án trên Github như ví dụ cuối bài viết này.

Còn chờ gì nữa hãy khám phá ngay về Markdown ngay bây giờ và tự tạo cho mình một tập tài liệu Markdown đơn giản nhé.

Markdown là gì ?

  • Markdown là một ngôn ngữ đánh dấu.Nó giúp chúng ta soạn thảo nhanh một văn bản
  • Nó có thể được chuyển sang HTML/XHTML hoặc những định dạng khác
  • Nó là một ngôn ngữ dễ đọc và dễ sử dụng
  • Phần đuôi mở rộng của file Markdown là .md (ví dụ README.md)

Markdown được sử dụng ở đâu ?

  • Sử dụng trong file Readme trên Github (phổ biến)
  • Trên các diễn đàn (Forum) và một số Blog Posts
  • Một số trang web tĩnh

Markdown làm được những gì ?

Với markdown bạn có thể tạo ra một số format sau :

  1. Headings
  2. Lists
  3. Emphasis
  4. Links
  5. Blocks of Code
  6. Images
  7. Blockquotes
  8. Horizontal Rules

Một số Markdown Editor

  • Text Editor Extensions (VSCode, Atom,…) (phổ biến)
  • MarkPad
  • HarooPad
  • MarkdownPad2
  • Typora

Nếu bạn sử dụng trình soạn thảo code VSCode thì bạn hãy cài đặt extension có tên là Auto-Open Markdown Preview.Extension này sẽ giúp bạn vừa soạn thảo file Markdown vừa có thể xem kết quả luôn.Tab soạn thảo và tab kết quả sẽ tự động hiển thị song song mỗi khi bạn mở file .md lên.

Tìm hiểu lý thuyết vậy thôi, giờ chúng ta vào thực hành luôn nhé.Bạn hãy mở trình soạn thảo VSCode lên và tạo một file với phần mở rộng là .md.

Cú pháp của Markdown

Headings

Để tạo ra Headings bạn hãy bắt đầu bằng dấu #.Bạn có thể tạo ra Heading từ H1 ~ H6 bằng cách tăng số lượng dấu # tương ứng.Bạn lưu ý là giữa dấu # và phần text của Heading phải có một khoảng trắng nhé.

Hướng dẫn sử dụng Markdown toàn tập ảnh 1

  • # H1
  • ## H2
  • ### H3
  • #### H4
  • #### H5
  • ###### H6

Tạo chữ in nghiêng

Để tạo chữ in nghiêng bạn có thể sử dụng một trong hai cách sau :

  • Cách 1 : sử dụng dấu * bao bọc phần text bạn muốn nó in nghiêng.Ví dụ : *Italics*
  • Cách 2 : sử dụng dấu _ bao bọc đoạn text bạn muốn nó in nghiêng.Ví dụ : _Italics_

Tạo chữ in đậm

Để tạo chữ in đậm bạn có thể lựa chọn một trong hai cách dưới đây :

  • Cách 1 : sử dụng dấu ** bao bọc phần text muốn nó in đậm.Ví dụ : **Strong**
  • Cách 2 : sử dụng 2 dấu _ liền nhau bao bọc phần text muốn in đậm.Ví dụ : __Strong__

Tạo gạch ngang chữ

Bạn hãy sử dụng 2 dấu ~ bao bọc phần text mà bạn muốn tạo gạch ngang cho nó.Ví dụ : ~~Strikethrough~~

Tạo đường thẳng ngăn cách

Đường thẳng ngăn cách được tạo ra bằng cách sử dụng 3 dấu gạch ngang .

Và dưới đây là hình ảnh ví dụ khi thực hành bốn format trên :

Hướng dẫn sử dụng Markdown toàn tập ảnh 2

Tạo blockquote

Tạo blockquote trong Markdown cực kì đơn giản.Cách tạo là bạn chỉ việc thêm đoạn quote ngay sau dấu > là được.Bạn lưu ý là giữa dấu > và đoạn quote phải có khoảng trắng ngăn cách nhé.

Ví dụ : > This is my quote

Tạo đường link

Cách tạo đường link trong Markdown hơi đặc biệt.

  • [text link](url link)

Trong cặp dấu ngoặc vuông [] là đoạn text link sẽ hiển thị cho người dùng và bên trong cặp dấu ngoặc tròn là đường dẫn link.

Ví dụ : [Google](https://www.google.com/)

Thêm hình ảnh

Cách thêm hình ảnh trong Markdown khá giống với cách thêm đường link.Bạn chỉ cần thêm dấu chấm than ở đầu là được.

  • ![Alt text](ulr image)

Lúc này thì phần text bên trong dấu ngoặc vuông sẽ là text của thẻ Alt.

Ví dụ : ![Text Image](https://picsum.photos/seed/picsum/200/300)

Dưới đây là hình ảnh cho ba format trên :

Hướng dẫn sử dụng Markdown toàn tập ảnh 3

Thêm danh sách dạng UL

Thêm danh sách dạng UL trong Markdown cực kì đơn giản.Bạn chỉ cần thêm text sau dấu * là ok.

  • * List item number

Bạn lưu ý là giữa dấu * và phần text cần có khoảng trắng nhé.

Thêm danh sách dạng OL

Thêm danh sách dạng OL thì bạn phải đánh số kèm theo dấu chấm và phía sau là text.

  • 1. List item number

Bạn lưu ý là số dùng để đánh dấu không cần theo thứ tự nhé.Hãy xem hình ảnh minh họa ở phía dưới để hiểu rõ hơn phần này.

Hướng dẫn sử dụng Markdown toàn tập ảnh 4

Tạo Inline  Code Block

Để tạo Inline Block Code trong Markdown bạn hãy viết code bên trong cặp dấu nháy ngay bên dưới nút esc.

Tạo Code Blocks

Để tạo một đoạn code trên nhiều dòng thì bạn hãy viết code bên trong cặp ba dấu nháy ngay là nút ngay bên dưới nút esc.

Bạn lưu ý là ngay sau dấu ba nháy mở thì bạn hãy thêm tên ngôn ngữ ứng với code của bạn để khi biên dịch phần code sẽ lên màu hợp lý.

Dưới đây là hình ảnh minh họa cho phần inline code block và code blocks.

Hướng dẫn sử dụng Markdown toàn tập ảnh 5

Tạo tables và tast list

Hướng dẫn sử dụng Markdown toàn tập ảnh 6

Về tạo tables và tast list thì đã có format code sẵn.Bạn chỉ việc thay phần nội dung bên trong mà thôi.

Nếu khi bạn soạn thảo Markdown mà cần hiển thị nguyên các kí tự đặc biệt như #, *,> … thì bạn có thể thêm dấu \ đằng trước những kí tự này để phần mềm biên dịch hiểu là không biên dịch phần kí tự đó.

Kết luận

Qua bài viết này mình đã chia sẻ với các bạn toàn bộ những kiến thức cơ bản nhất về Markdown.Chỉ cần thành thạo những kiến thức này thôi là bạn đã đủ tạo ra cho mình một tài liệu Markdown hoàn chỉnh.

Sau khi bạn tự tạo ra cho mình một file markdown rồi thì bạn hãy thử upload lên trên Github và quan sát kết quả nhé.Bạn có thể theo dõi phần mẫu ví dụ về Markdown trên Github theo đường link dưới đây.

 

Nếu bạn thấy bài viết này hay và có ích thì bạn có thể ủng hộ blog của mình bằng một trong số những cách sau để mình có thêm động lực xuất bản nhiều bài viết mới chất lượng hơn nữa.

  • Chia sẻ bài viết này lên mạng xã hội qua các nút bên dưới đây.
  • Thả tim ở ngay cuối cùng bài viết này.
  • Đăng kí nhận thông báo bài viết mới bằng cách nhấn vào chuông đỏ góc dưới cùng bên trái.
  • Đánh giá chất lượng bài viết bằng sao ở trên cùng bài viết này.

Tìm kiếm bài viết trên blog với Google Search :

Bài viết có thể bạn sẽ thích

guest
0 Comments
Inline Feedbacks
View all comments
0
Hãy cùng thảo luận về bài viếtx
()
x