Hướng dẫn đánh dấu cho người mới bắt đầu: Mọi thứ bạn cần biết để bắt đầu

Mục lục

• Markdown là gì?
  • Ưu điểm của việc sử dụng Markdown
• Bắt đầu với Markdown
  • Định dạng cơ bản trong Markdown
  • Định dạng nâng cao trong Markdown
• Ứng dụng trong thế giới thực trên Markdown
• Tài nguyên

Khả năng trình bày suy nghĩ và ý tưởng của bạn một cách rõ ràng và chính xác là điều quan trọng bất kể bạn làm việc trong ngành nào. May mắn thay, có rất nhiều công cụ và công nghệ hỗ trợ tạo ra nội dung văn bản hay.

Nhập Markdown - một ngôn ngữ đánh dấu linh hoạt nhưng khiêm tốn đã trở thành ngôn ngữ chính cho các nhà văn, lập trình viên và người tạo nội dung thuộc mọi loại.

Nếu bạn chưa quen với lĩnh vực Markdown, đừng sợ; hướng dẫn này được thiết kế để làm kim chỉ nam cho bạn trên hành trình làm chủ ngôn ngữ đánh dấu thân thiện với người dùng này.

Markdown là gì?

Markdown là ngôn ngữ đánh dấu nhẹ giúp đơn giản hóa quá trình định dạng văn bản cho web và các phương tiện khác. Nó được John Gruber và Aaron Swartz tạo ra vào năm 2004 như một cách viết nội dung có thể dễ dàng chuyển đổi sang HTML và các định dạng khác mà không cần kiến thức kỹ thuật sâu rộng.

Nó đặc biệt phổ biến đối với các nhà văn, người viết blog, lập trình viên và bất kỳ ai cần một cách đơn giản và hiệu quả để định dạng văn bản cho web.

Ưu điểm của việc sử dụng Markdown

1. Đơn giản và dễ đọc: Markdown sử dụng cú pháp đơn giản bằng cách sử dụng các ký tự văn bản thuần túy. Tính đơn giản này giúp bạn dễ dàng tìm hiểu và sử dụng, cho phép bạn tập trung vào chính nội dung thay vì các mã định dạng phức tạp.

2. Độc lập với nền tảng: Markdown không phụ thuộc vào nền tảng. Bạn có thể tạo tài liệu Markdown trên bất kỳ thiết bị nào bằng trình soạn thảo văn bản hoặc trình chỉnh sửa mã và những tài liệu này có thể dễ dàng xem và chuyển đổi thành nhiều định dạng khác nhau trên các nền tảng khác nhau. Tính nhất quán này đảm bảo khả năng truy cập và tuổi thọ của nội dung của bạn.

3. Đường cong học tập nhanh: Markdown có một trong những cú pháp dễ dàng nhất. Điều này có nghĩa là bạn có thể học nó trong một khoảng thời gian ngắn. Cú pháp trực quan, giống với định dạng bạn có thể đã sử dụng trong email hoặc tin nhắn văn bản.

Đường cong học tập nhanh chóng này khuyến khích những người dùng không rành về kỹ thuật áp dụng.

4. Áp dụng rộng rãi: Markdown đã trở nên phổ biến rộng rãi và được hỗ trợ trên nhiều nền tảng, bao gồm các hệ thống viết blog như WordPress, các công cụ cộng tác như GitHub và hệ thống quản lý nội dung. Điều này làm cho Markdown trở thành một kỹ năng có giá trị có thể được áp dụng trong nhiều bối cảnh.

5. Tốc độ và hiệu quả: Tạo nội dung trong Markdown nhanh chóng và hiệu quả. Với một vài ký tự đơn giản và các thành phần định dạng khác. Đổi lại, điều này cho phép người dùng tạo tài liệu một cách đơn giản, hiệu quả và tốc độ.

6. Kiểm soát phiên bản: Khi sử dụng Markdown phối hợp với các hệ thống kiểm soát phiên bản như Git, những thay đổi được thực hiện đối với tệp Markdown rất dễ theo dõi. Điều này giúp việc cộng tác trên các dự án, xem xét các thay đổi và duy trì hồ sơ chỉnh sửa rõ ràng trở nên đơn giản hơn.

Bắt đầu với Markdown

Markdown hoạt động trong nhiều trình soạn thảo văn bản và trình soạn thảo mã. Vì mục đích của bài viết này, chúng tôi sẽ tập trung vào việc sử dụng markdown trong các trình soạn thảo mã, đặc biệt là VS Code . Mặc dù vậy, cú pháp tương tự có thể được tuân theo trong các trình soạn thảo văn bản.

1. Đầu tiên, trong Mã VS của bạn, hãy tạo một thư mục (Bạn có thể đặt tên bất cứ thứ gì bạn muốn). Trong thư mục đó, tạo một tệp có tên markdown.md

   
   

2. Điều hướng đến phần trên cùng bên phải của tệp VS Code và nhấp vào nút xem trước để xem trước kết quả của bạn cạnh nhau.

   

Định dạng cơ bản trong Markdown

Dưới đây là một số cú pháp cơ bản để định dạng văn bản trong Markdown.

1. Tiêu đề : Tiêu đề được sử dụng để biểu thị các cấp Tiêu đề khác nhau trong tài liệu của bạn. Để tạo Tiêu đề trong Markdown, hãy sử dụng ký hiệu # theo sau là dấu cách rồi đến văn bản Tiêu đề của bạn. Lưu ý rằng số lượng ký hiệu # xác định cấp độ Tiêu đề của bạn. Xem ví dụ dưới đây.

    # Heading ## Heading ### Heading 

   

2. Nhấn mạnh: Bạn có thể thêm điểm nhấn cho văn bản của mình bằng cách in đậm hoặc in nghiêng. Để in đậm văn bản, hãy đặt nó trong dấu hoa thị kép ** hoặc dấu gạch dưới kép __ . Để in nghiêng văn bản, hãy đặt nó trong các dấu hoa thị * hoặc dấu gạch dưới đơn _ .

Ví dụ:

 This is the **Bold Text** This is *italics* 

3. Danh sách: Markdown hỗ trợ cả danh sách có thứ tự (đánh số) và không có thứ tự (dấu đầu dòng). Để tạo danh sách có thứ tự, hãy bắt đầu mỗi mục bằng một số, theo sau là dấu chấm. Để tạo danh sách không có thứ tự, hãy sử dụng dấu hoa thị * , dấu cộng + hoặc dấu gạch nối - .

Ví dụ:

 Ordered List: 1. First item 2. Second item 3. Third item Unordered List: * Item 1 * Item 2 * Item 3 

4. Liên kết: Bạn có thể tạo siêu liên kết trong Markdown bằng cách sử dụng dấu ngoặc vuông [] cho văn bản liên kết và dấu ngoặc đơn () cho URL liên kết.

Ví dụ:

 [Visit Odafe's Website](https://www.odafe.vercel.app)

5. Hình ảnh: Chèn hình ảnh cũng tương tự như tạo link; sự khác biệt duy nhất là dấu chấm than ! trước dấu ngoặc vuông. Văn bản thay thế trong dấu ngoặc vuông được sử dụng để mô tả hình ảnh cho khả năng truy cập.

Ví dụ:

 ![Alt text](image-url.jpg)

6. Blockquotes : Blockquote dùng để hiển thị văn bản trích dẫn. Để tạo điều này, chỉ cần bắt đầu dòng với ký hiệu > theo sau là văn bản bạn muốn trích dẫn.

Ví dụ:

 > This is a quote by Odafe

Đầu ra trông như thế này:

Đây là trích dẫn của Odafe

7. Quy tắc ngang : Bạn có thể thêm dấu phân cách ngang bằng cách sử dụng ba dấu gạch dưới _ .

Ví dụ:

 This is a regular text ____ This is more regular text 

Đây là những yếu tố nền tảng của định dạng cơ bản trong Markdown. Bằng cách nắm vững các khái niệm này, bạn sẽ có thể tạo nội dung có cấu trúc tốt và hấp dẫn về mặt hình ảnh, cho dù bạn đang viết một ghi chú đơn giản hay soạn thảo một tài liệu phức tạp hơn.

Định dạng nâng cao trong Markdown

Markdown cũng cung cấp chức năng bổ sung trong trường hợp bạn có thể cần thêm các phần tử phức tạp hơn vào tài liệu của mình. Một số tùy chọn định dạng này là:

1. Khối mã và mã nội tuyến : Bạn có thể dễ dàng thêm các khối mã vào tệp của mình bằng cách bắt đầu các khối mã bằng ba dấu gạch ngược (```), theo sau là ngôn ngữ mà khối mã của bạn được viết. Mã nội tuyến được thêm bằng cách gói đoạn mã trong dấu backticks đơn.

Ví dụ:

 This is a HTML element `<div>Hello World</div>` ```javascript function myFunction() { console.log("Hello world!") } 

2. Danh sách nhiệm vụ: Danh sách nhiệm vụ rất hữu ích cho việc tạo danh sách việc cần làm. Để tạo danh sách nhiệm vụ, hãy sử dụng dấu ngoặc vuông có dấu "x" cho các nhiệm vụ đã hoàn thành và khoảng trắng cho các nhiệm vụ chưa hoàn thành.

Ví dụ:

 - [x] A complete task - [ ] An incomplete task 

3. Biểu tượng cảm xúc : Có hai cách để thêm biểu tượng cảm xúc vào tệp Markdown: sao chép và dán biểu tượng cảm xúc vào văn bản có định dạng Markdown của bạn hoặc nhập mã ngắn biểu tượng cảm xúc .

4. Văn bản gạch ngang: Để gạch ngang văn bản, hãy sử dụng dấu ngã kép ( ~~ ) xung quanh văn bản bạn muốn gạch ngang.

Ví dụ:

 This is a ~~Strikethrough~~ text.

5. Ký tự thoát: Nếu bạn cần hiển thị các ký tự có ý nghĩa đặc biệt trong Markdown, bạn có thể thoát chúng bằng dấu gạch chéo ngược ( \ ).

 To display a literal asterisk \* use a backslash before it.

6. Chỉ số trên và Chỉ số dưới: Để tạo chỉ số trên, văn bản chỉ số trên được gói trong hai ký hiệu ^ .

Để tạo văn bản chỉ số dưới, văn bản được gói trong hai ký hiệu ~ .

Ví dụ:

 This is how a superscript is written: X^2^ This is how a subscript is written: H~2~O. 

7. Tables : Để tạo bảng trong Markdown, hãy làm theo các bước sau:

• Bắt đầu và kết thúc mỗi hàng bằng ký hiệu ống dẫn ( | ).
• Phân cách mỗi cột bằng ký hiệu ống ( | ).
• Sử dụng ba dấu gạch nối trở lên ( --- ) để tạo tiêu đề cột.

 | Syntax | Description | | ----------- | ----------- | | Header | Title | | Paragraph | Text |

Đầu ra:

8. Đánh dấu : Bạn có thể đánh dấu các từ quan trọng trong tài liệu của mình bằng cách sử dụng hai dấu bằng ( == ) trước và sau (các) từ đó.

Ví dụ:

 This highlighted word is ==Bee==

Đầu ra:

9. Chú thích cuối trang : Chú thích cuối trang là cách thêm ghi chú và tài liệu tham khảo vào cuối tài liệu của bạn mà không làm lộn xộn phần nội dung chính. Để tạo tham chiếu chú thích cuối trang, hãy thêm ký hiệu dấu mũ ( ^ ) và mã định danh duy nhất (thường là số hoặc từ) bên trong dấu ngoặc ( [^1] ).

Mã định danh không thể chứa dấu cách hoặc tab. Ở đầu ra, chú thích cuối trang được đánh số tuần tự.

Ví dụ:

 This is an example sentence with a footnote[^1]. [^1]: This is the content of the footnote.

Đầu ra:

Bạn có thể tìm hiểu thêm về định dạng nâng cao trong Markdown tại đây.

Ứng dụng trong thế giới thực trên Markdown

Markdown đã trở nên phổ biến trong cộng đồng lập trình và phát triển phần mềm. Đáng chú ý, nó đã tìm thấy một vai trò then chốt trong các nền tảng kiểm soát phiên bản, đóng vai trò như một phương tiện toàn diện và dễ tiếp cận để giải thích bản chất của cơ sở mã.

Bằng cách sử dụng Markdown làm công cụ mô tả sự phức tạp trong mã của một người, các nhà phát triển tạo ra sự kết hợp hài hòa giữa sự rõ ràng và bối cảnh.

Cách thực hành này giúp ích rất nhiều cho những người tình cờ tìm thấy kho lưu trữ mã của họ, tạo điều kiện nắm bắt nhanh chóng và sâu sắc mục đích và sắc thái tổng thể của dự án.

Theo cách này, Markdown không chỉ đóng vai trò là một công cụ định dạng mà còn là một công cụ giao tiếp mạnh mẽ, thu hẹp khoảng cách giữa những nỗ lực mã hóa phức tạp và ý nghĩa sâu sắc trong thế giới thực của chúng.

Phần kết luận

Hãy nhớ rằng, Markdown không chỉ là một công cụ; đó là cầu nối kết nối suy nghĩ của bạn với khán giả toàn cầu, giúp giọng nói của bạn được lắng nghe một cách rõ ràng và có tác động.

Khả năng tương thích với nhiều nền tảng khác nhau, tính đơn giản và khả năng thích ứng của nó đảm bảo rằng hành trình của bạn với Markdown không bị giới hạn trong hướng dẫn này mà vẫn tiếp tục khi bạn khám phá những cách mới để thể hiện bản thân và ý tưởng của mình.

Tài nguyên

• Bảng cheat: https://www.markdownguide.org/cheat-sheet/

• Hướng dẫn: https://www.markdowntutorial.com/

• Hướng dẫn: https://commonmark.org/help/tutorial/

  
  

Cũng được xuất bản ở đây