Markdown là một ngôn ngữ. Nó không phải là một ngôn ngữ lập trình, mặc dù. Đó là những gì chúng ta gọi là ngôn ngữ đánh dấu. Ngôn ngữ đánh dấu là một cách chú thích tài liệu văn bản để bao gồm các gợi ý về cách hiển thị tài liệu. Khi tài liệu đánh dấu được xử lý [i. e. hiển thị], ngôn ngữ đánh dấu không được hiển thị. Thay vào đó, nó được sử dụng để định dạng văn bản và chỉ văn bản được định dạng được hiển thị
Theo Wikipedia, đánh dấu tên xuất phát từ việc "đánh dấu" các bản thảo trên giấy, điều mà các biên tập viên làm khi đề xuất sửa chữa
Ok, vậy đó là một cái tên lạ mắt, nhưng markdown là gì? . Markdown về cơ bản là một cách để viết văn bản được định dạng
Các tùy chọn định dạng được cho phép bởi markdown không đa dạng [ví dụ: bạn không thể chỉ định kiểu phông chữ hoặc màu sắc], nhưng chúng đủ mạnh để tăng đáng kể khả năng đọc của tài liệu văn bản. Sử dụng đánh dấu, bạn có thể nhanh chóng bao gồm tiêu đề, liên kết, hình ảnh, văn bản in đậm hoặc in nghiêng, đoạn văn và danh sách có thứ tự hoặc không có thứ tự
Trong hướng dẫn này, chúng tôi sẽ sử dụng sổ ghi chép Jupyter để minh họa đánh dấu, tuy nhiên lưu ý rằng đánh dấu không dành riêng cho Jupyter. Nhiều dịch vụ và sản phẩm khác sử dụng nó để cho phép định dạng văn bản dễ dàng
GHI CHÚ. Trong hướng dẫn nhanh của chúng tôi về cách sử dụng sổ ghi chép Jupyter, chúng tôi đã đề cập rằng Jupyter cho phép thay đổi loại ô để biến nó thành ô đánh dấu. Để làm theo các ví dụ bên dưới, vui lòng đảm bảo thay đổi loại ô của bạn từ mã sang đánh dấu trong sổ ghi chép Jupyter của bạn
Ưu điểm của việc sử dụng Markdown là gì?
Tất nhiên, bạn có thể định dạng văn bản trong trình soạn thảo văn bản, vậy tại sao bạn lại chọn đánh dấu?
Trước hết, không giống như định dạng văn bản được nhiều trình soạn thảo sử dụng, markdown chỉ là văn bản thuần túy, nghĩa là rất dễ chia sẻ giữa các máy tính. Nó không phải là độc quyền, vì vậy bất cứ ai cũng có thể sử dụng nó
Nó cũng rất đơn giản, nhưng khá mạnh mẽ. Chỉ cần một vài biểu tượng và quy tắc để viết đánh dấu
Và cuối cùng, nhưng không kém phần quan trọng, nó tương thích với web. Điều tôi muốn nói ở đây là markdown có thể dễ dàng được chuyển đổi thành HTML và do đó, nó có thể dễ dàng được hiển thị trong trình duyệt
Trên thực tế, đây chính xác là những gì xảy ra trong sổ ghi chép Jupyter. Bởi vì sổ ghi chép Jupyter được hiển thị trong trình duyệt, phần đánh dấu thực sự được chuyển đổi thành HTML và chính các thẻ HTML khác nhau sẽ cho trình duyệt biết cách thực sự hiển thị văn bản được định dạng đánh dấu
Mặc dù HTML nằm ngoài phạm vi của hướng dẫn này, đây là một vài ví dụ về loại chuyển đổi từ đánh dấu xuống sang HTML xảy ra khi đánh dấu xuống được hiển thị trong sổ ghi chép Jupyter
- văn bản in đậm trở thành văn bản thuần túy bên trong các thẻ mạnh. Trình duyệt hiển thị văn bản bên trong văn bản mạnh in đậm
- hình ảnh được chuyển đổi sang thẻ img. Trình duyệt biết cách hiển thị các thẻ này dưới dạng hình ảnh
- tiêu đề được chuyển đổi thành h1, h2, v.v. thẻ. Trình duyệt biết cách hiển thị các thẻ này dưới dạng tiêu đề
Khi nào và tại sao tôi nên sử dụng Markdown trong Máy tính xách tay Jupyter?
Markdown là một cách để định dạng văn bản. Theo mặc định, các ô của sổ ghi chép Jupyter được định dạng để hiển thị mã, do đó, không có đánh dấu xuống, không có cách nào dễ dàng để đưa văn bản giải thích vào sổ ghi chép của bạn. Tất nhiên, bạn luôn có thể bao gồm các nhận xét về mã, nhưng chúng không thể được định dạng. Và những gì về các liên kết hoặc hình ảnh?
Sổ ghi chép Jupyter rất phù hợp để trình bày công việc thuộc loại nghiên cứu. Trên thực tế, đó là nguồn gốc của chúng - trong việc trình bày công trình khoa học
Ví dụ: hãy xem xét ảnh chụp màn hình bên dưới, đại diện cho một phần nhỏ của sổ ghi chép Jupyter mà tôi đã viết giới thiệu khái niệm hồi quy tuyến tính trong học máy cổ điển
Lưu ý cách các ô đánh dấu và mã xen kẽ liền mạch như thế nào, cho phép tôi tạo một bản trình bày bao gồm cả văn bản giải thích và mã thực thi. Mặc dù tôi có thể đã sử dụng các nhận xét Python thay vì các ô đánh dấu, nhưng tôi cho rằng đánh dấu đó tạo ra trải nghiệm thú vị hơn nhiều cho người đọc
Vì vậy, để tóm tắt, tôi khuyến khích bạn sử dụng đánh dấu trong sổ ghi chép Jupyter của mình bất cứ khi nào bạn phải đưa vào một lượng lớn văn bản thuần túy sẽ có lợi khi được định dạng
Nếu bạn bị thuyết phục và muốn tìm hiểu markdown, thì hãy chuyển sang phần hướng dẫn. Markdown rất đơn giản - bạn sẽ chỉ cần vài phút và bạn sẽ trở thành chuyên gia về nó
GHI CHÚ. Dưới đây, chúng tôi hiển thị phần đánh dấu [những gì bạn cần nhập] bằng màu tím và kết quả được hiển thị ngay bên dưới nó
In đậm
Để viết văn bản in đậm, chỉ cần bao quanh văn bản bằng dấu **. Ví dụ
**đây là chữ in đậm**
đây là một văn bản in đậm
Chữ in nghiêng
Để viết văn bản in nghiêng, chỉ cần bao quanh văn bản bằng _. Ví dụ
_đây là chữ in nghiêng_
đây là một văn bản in nghiêng
Đậm và nghiêng
Để viết văn bản vừa in đậm vừa in nghiêng, hãy sử dụng cả ** và _. Ví dụ
**_cái này vừa đậm vừa nghiêng_**
cái này vừa đậm vừa nghiêng
đoạn văn
Có lẽ điều khó hiểu nhất về đánh dấu cho người mới bắt đầu là các đoạn văn. Đây là lý do tại sao. hãy thử nhập văn bản sau vào ô đánh dấu sổ ghi chép Jupyter
Hai gia đình, cả hai đều giống nhau về phẩm giá,
Ở Verona công bằng, nơi chúng ta đặt bối cảnh của mình,
Từ mối hận thù cổ xưa đến cuộc binh biến mới,< .
Where civil blood makes civil hands unclean.
Nếu bạn nhập những dòng này từ Romeo và Juliet của Shakespeare chính xác như chúng xuất hiện ở trên, văn bản sẽ được hiển thị như sau
Hai gia đình, cả hai đều giống nhau về phẩm giá, Ở Verona công bằng, nơi chúng ta đặt bối cảnh, Từ mối hận thù cổ xưa đến cuộc binh biến mới, Nơi dòng máu dân sự làm cho bàn tay dân sự trở nên ô uế
Điều gì đã xảy ra với ngắt dòng? . Thay vào đó, nó cung cấp hai cách ngắt dòng. phá vỡ mềm và phá vỡ cứng
nghỉ mềm
Ngắt mềm đạt được bằng cách thêm hai khoảng trắng sau mỗi dòng. Hãy xem lại ví dụ trên và bây giờ hãy thêm hai khoảng trắng sau mỗi dòng
GHI CHÚ. Vì khoảng trắng là vô hình, bên dưới chúng tôi biểu thị từng khoảng trắng bằng ký hiệu +, nhưng khi bạn thử điều này trong sổ ghi chép Jupyter của mình, hãy đảm bảo thay thế các ký hiệu + bằng dấu cách
Hai gia đình, cả hai đều giống nhau về phẩm giá,++
Ở Verona công bằng, nơi chúng ta đặt bối cảnh của mình,++
Từ mối hận thù xa xưa đến .
Where civil blood makes civil hands unclean.
Nếu bạn gõ những dòng có hai khoảng trắng ở cuối thì văn bản sẽ được hiển thị như sau
Hai gia đình, cả hai đều giống nhau về phẩm giá,
Ở Verona công bằng, nơi chúng ta đặt bối cảnh của mình,
Từ mối hận thù cổ xưa đến cuộc binh biến mới,< .
Where civil blood makes civil hands unclean.
Nghỉ giải lao khó khăn
Dấu ngắt cứng được sử dụng để phân tách các đoạn văn. Bạn có thể đạt được điều này trong phần đánh dấu bằng cách thêm một dòng trống vào giữa các đoạn văn. Ví dụ: xem xét phần đánh dấu sau đây của hai đoạn trong Bức tranh về Dorian Gray của Oscar Wilde
Ở giữa phòng, được kẹp vào một giá vẽ thẳng đứng, là bức chân dung toàn thân của một chàng trai trẻ có vẻ đẹp cá nhân phi thường, và phía trước bức chân dung đó, cách đó một khoảng, là chính nghệ sĩ, Basil Hallward, người đột ngột
Khi người họa sĩ nhìn vào hình dáng duyên dáng và duyên dáng mà anh ta đã phản chiếu một cách khéo léo trong nghệ thuật của mình, một nụ cười hài lòng lướt qua khuôn mặt anh ta và dường như sắp nán lại ở đó. Nhưng anh ta đột nhiên giật mình, nhắm mắt lại, đặt ngón tay lên mí mắt, như thể anh ta tìm cách giam cầm trong não mình một giấc mơ kỳ lạ nào đó mà anh ta sợ rằng mình có thể đánh thức.
Chú ý dấu ngắt [dòng trống] ở giữa hai đoạn văn. Nếu chúng tôi hiển thị đánh dấu này trong sổ ghi chép Jupyter, nó sẽ hiển thị dưới dạng
Ở giữa phòng, được kẹp vào một giá vẽ thẳng đứng, là bức chân dung toàn thân của một chàng trai trẻ có vẻ đẹp cá nhân phi thường, và phía trước bức chân dung đó, cách đó một khoảng, là chính nghệ sĩ, Basil Hallward, người đột ngột
Khi người họa sĩ nhìn vào hình dáng duyên dáng và duyên dáng mà anh ta đã phản chiếu một cách khéo léo trong nghệ thuật của mình, một nụ cười hài lòng lướt qua khuôn mặt anh ta và dường như sắp nán lại ở đó. Nhưng anh ta đột nhiên giật mình, nhắm mắt lại, đặt ngón tay lên mí mắt, như thể anh ta tìm cách giam cầm trong não mình một giấc mơ kỳ lạ nào đó mà anh ta sợ rằng mình có thể đánh thức.
Đó chính là điều chúng ta cần khi viết đoạn văn
Muốn tìm hiểu thêm?
tiêu đề
Có 6 cấp độ tiêu đề trong markdown. h1, h2, h3, h4, h5 và h6. h1 là lớn nhất, h6 là nhỏ nhất. Để viết tiêu đề, hãy bao gồm # trước văn bản cho tiêu đề h1, ## trước văn bản cho tiêu đề h2, ### trước văn bản cho tiêu đề h3, v.v.
GHI CHÚ. Trong sổ ghi chép Jupyter, bạn phải để khoảng cách giữa nhóm dấu # và văn bản. Nói chung, điều này không bắt buộc trong đánh dấu, mà đúng hơn, đó là một cách giải quyết máy tính xách tay Jupyter
Ví dụ
# đây là tiêu đề 1
## đây là tiêu đề 2
đây là tiêu đề 2
### đây là tiêu đề 3
đây là tiêu đề 3
#### đây là tiêu đề 4
đây là tiêu đề 4
##### đây là tiêu đề 5
đây là tiêu đề 5GHI CHÚ. Trong sổ ghi chép Jupyter, tiêu đề 5 [h5] được hiển thị ở cả dạng in đậm và in nghiêng
###### đây là tiêu đề 6
đây là tiêu đề 6GHI CHÚ. Trong sổ ghi chép Jupyter, tiêu đề 5 [h5] và tiêu đề 6 [h6] được hiển thị giống hệt nhau
liên kết
Markdown cho phép bạn dễ dàng chèn liên kết vào văn bản thuần túy. Để làm điều đó, chỉ cần bọc văn bản cho liên kết trong [ ] và bọc URL trong [ ]
GHI CHÚ. Nhớ bao gồm http. // hoặc https. // đối với các liên kết tuyệt đối, nếu không thì các liên kết sẽ được coi là tương đối
[đây là liên kết đến Edlitera][https. //www. người học chữ. com/]
đây là một liên kết đến Edlitera
Hình ảnh
Thêm hình ảnh vào ô đánh dấu sổ ghi chép Jupyter rất giống với việc thêm liên kết. Sự khác biệt duy nhất là dấu ngoặc vuông được đặt trước bằng dấu chấm than
[hình ảnh con mèo ngồi trên ghế][https. //www. người học chữ. com/hình ảnh/mèo. jpg]
Nguồn hình ảnh. Ảnh của Kari Shea trên Bapt
GHI CHÚ. Khi hiển thị hình ảnh trong phần đánh dấu, văn bản nằm giữa dấu ngoặc vuông [e. g. [hình ảnh con mèo ngồi trên ghế]] trở thành giá trị được gán cho thuộc tính alt của hình ảnh. Thuộc tính này rất quan trọng đối với khả năng truy cập. Trình đọc màn hình sử dụng giá trị của thuộc tính này để mô tả hình ảnh cho những người có thể gặp khó khăn khi nhìn thấy hình ảnh đó. Vì vậy, mặc dù bạn có thể để trống [và hình ảnh vẫn hiển thị], bạn nên tập thói quen thêm nó bằng cách thêm văn bản mô tả vào giữa các dấu ngoặc vuông
trích dẫn khối
Blockquotes được sử dụng để thu hút sự chú ý đến các trích dẫn từ các nguồn khác. Chúng không phổ biến trong sổ ghi chép Jupyter, tuy nhiên tôi sẽ giới thiệu chúng ở đây, trong trường hợp bạn cần. Để hiển thị các trích dẫn khối, chỉ cần thêm dấu "lớn hơn" [>] trước văn bản bạn muốn trích dẫn
> Ai đó từng nói với tôi rằng thời gian là kẻ săn mồi rình rập chúng ta cả đời. Nhưng tôi tin rằng thời gian là người bạn đồng hành cùng ta trên mọi nẻo đường và nhắc nhở ta hãy trân trọng từng phút giây vì chúng sẽ không bao giờ quay trở lại. Ta để lại gì không quan trọng bằng ta đã sống như thế nào. **Jean-Luc Picard**
Ai đó đã từng nói với tôi rằng thời gian là kẻ săn mồi rình rập chúng ta cả đời. Nhưng tôi tin rằng thời gian là người bạn đồng hành cùng ta trên mọi nẻo đường và nhắc nhở ta hãy trân trọng từng phút giây vì chúng sẽ không bao giờ quay trở lại. Ta để lại gì không quan trọng bằng ta đã sống như thế nào. Jean-Luc Picard
GHI CHÚ. Chúng tôi đã bao gồm một số văn bản in đậm trong blockquote của mình, làm ví dụ. Điều này chỉ để cho thấy rằng bạn có thể kết hợp nhiều định dạng đánh dấu khác nhau để đạt được chính xác những gì bạn cần
danh sách
Chúng tôi có hai loại danh sách. có thứ tự và không có thứ tự
danh sách có thứ tự
Trong danh sách có thứ tự, mỗi mục danh sách bắt đầu bằng một số. Điều thú vị về đánh dấu trong sổ ghi chép Jupyter là bạn không cần phải tự thêm các số. Ví dụ: bạn có thể bắt đầu mỗi mục danh sách bằng 1 và khi phần đánh dấu được hiển thị, các số chính xác sẽ được điền vào
Tính năng này giúp bạn dễ dàng sắp xếp lại các mục mà không cần phải chỉnh sửa tất cả các số đó
Những gì bạn cần gõ
Những gì được hiển thị
danh sách không có thứ tự
Danh sách không có thứ tự là danh sách bắt đầu bằng dấu đầu dòng. Chúng cũng rất dễ tạo với markdown
Những gì bạn cần gõ
Những gì được hiển thị
Danh sách có thể lồng nhau. Bạn cũng có thể trộn và kết hợp. Kiểm tra ví dụ dưới đây
Những gì bạn cần gõ
Những gì được hiển thị
Hy vọng rằng điều này mang lại cho bạn cảm giác về việc tạo danh sách trong markdown dễ dàng như thế nào. Cũng lưu ý rằng sổ ghi chép Jupyter bao gồm tô sáng cú pháp để đánh dấu, giúp dễ dàng phân biệt giữa các cấp độ khác nhau của danh sách lồng nhau của bạn