MarkdownPhương tiện gì?
Làm thế nào để sử dụng cú pháp Markdown / đánh dấu định dạng?
Tổng quat
Markdown là một ngôn ngữ đánh dấu nhẹ được tạo ra bởi John Gruber.
Nó cho phép mọi người "viết tài liệu ở định dạng văn bản thuần túy dễ đọc và dễ viết, sau đó chuyển đổi chúng thành tài liệu XHTML (hoặc HTML) hợp lệ".
Ngôn ngữ này kết hợp nhiều tính năng của đánh dấu văn bản thuần túy đã có trong e-mail.
John Gruber đã tạo ra ngôn ngữ Markdown vào năm 2004, với sự cộng tác của Aaron Swartz phần lớn về ngữ pháp.Mục đích của ngôn ngữ là sử dụng "định dạng văn bản thuần túy dễ đọc, dễ viết và có thể tùy chọn chuyển đổi sang XHTML (hoặc HTML) hợp lệ".
mục đích
Mục tiêu của Markdown là "dễ đọc và dễ viết".
dễ đọc, hãy làm điều đó bằng mọi cách网络 营销, trải nghiệm người dùng là rất quan trọng.
Tệp được viết bằng Markdown có thể được xuất bản trực tiếp dưới dạng văn bản thuần túy và không được bao gồm nhiều thẻ hoặc lệnh định dạng.
Cú pháp Markdown bị ảnh hưởng bởi một số định dạng chuyển văn bản sang HTML hiện có, bao gồm Setext, atx, Textile, reStructuredText, Grutatext và EtText, nhưng nguồn cảm hứng lớn nhất là định dạng email văn bản thuần túy.
Tóm lại, cú pháp của Markdown bao gồm tất cả các ký hiệu, được lựa chọn cẩn thận và chức năng của chúng rõ ràng trong nháy mắt.Ví dụ: đặt dấu hoa thị xung quanh văn bản để làm cho văn bản trông giống như * nhấn mạnh *.
Danh sách trong Markdown trông giống như danh sách. Các đoạn trích dẫn trong Markdown thực sự giống như trích dẫn một đoạn văn bản, giống như bạn đã thấy trong email.
Tương thích với HTML
Mục tiêu của ngữ pháp Markdown là trở thành một ngôn ngữ viết cho web.
Markdown không có nghĩa là để thay thế HTML, hoặc thậm chí gần giống với nó, nó có rất ít cú pháp và chỉ tương ứng với một tập hợp con nhỏ của đánh dấu HTML. Markdown không được hình thành để làm cho các tài liệu HTML dễ viết hơn.
Theo tôi, HTML đã dễ viết. Ý tưởng của Markdown là làm cho các tài liệu dễ đọc, dễ viết và thay đổi theo ý muốn. HTML là một định dạng xuất bản, Markdown là mộtCopywritingđịnh dạng văn bản.Như vậy, cú pháp định dạng của Markdown chỉ bao gồm những gì văn bản thuần túy có thể.
Các thẻ không thuộc phạm vi của Markdown có thể được viết bằng HTML trực tiếp trong tài liệuQuảng cáo trên websao chép.Không cần phải đánh dấu đây là HTML hoặc Markdown; chỉ cần thêm trực tiếp đánh dấu.
Chỉ một số phần tử khối HTML bị hạn chế - chẳng hạn như <div>,<table>,<pre>,<p> và các thẻ khác, chúng phải được tách biệt với các vùng nội dung khác bằng các dòng trống trước và sau, đồng thời các thẻ mở và đóng của chúng không được thụt lề với các tab hoặc dấu cách. Trình tạo Markdown đủ thông minh để không thêm các thẻ khối HTML không cần thiết <p> nhãn.
Ví dụ như sau, thêm một bảng HTML vào tệp Markdown:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
Lưu ý rằng cú pháp định dạng Markdown giữa các thẻ khối HTML sẽ không được xử lý.Ví dụ: nếu bạn sử dụng kiểu Markdown bên trong khối HTML*强调*sẽ không có hiệu lực.
Các thẻ phần HTML (nội dòng) chẳng hạn như <span>,<cite>,<del> Có thể được sử dụng tự do trong các đoạn văn, danh sách hoặc tiêu đề Markdown.Theo thói quen cá nhân, bạn thậm chí có thể sử dụng thẻ HTML để định dạng mà không cần sử dụng định dạng Markdown.Ví dụ: Nếu bạn thích HTML <a> 或 <img> , có thể được sử dụng trực tiếp mà không cần liên kết hoặc cú pháp thẻ hình ảnh do Markdown cung cấp.
Không giống như giữa các thẻ khối HTML, cú pháp Markdown hợp lệ giữa các thẻ phần HTML.
Chuyển đổi tự động các ký tự đặc biệt
Trong tệp HTML, có hai ký tự yêu cầu xử lý đặc biệt: < Và & . < các ký hiệu được sử dụng cho các thẻ bắt đầu,& Các biểu tượng được sử dụng để đánh dấu các thực thể HTML, nếu bạn chỉ muốn hiển thị nguyên mẫu của các ký tự này, bạn phải sử dụng biểu mẫu thực thể, như < Và &.
& Các nhân vật đặc biệt gây đau khổ cho những người viết tài liệu web, nếu bạn định gõ "AT&T", bạn phải viết "AT&T".trong khi ở trong URL & Các ký tự cũng được chuyển đổi.Ví dụ bạn muốn liên kết đến:
http://images.google.com/images?num=30&q=larry+bird
Bạn phải viết chuyển đổi URL là:
http://images.google.com/images?num=30&q=larry+bird
được đặt trong thẻ liên kết href trong tài sản.Không cần phải nói, điều này rất dễ bị bỏ qua và có lẽ là số lỗi lớn nhất được phát hiện bởi xác thực các tiêu chuẩn HTML.
Markdown cho phép bạn viết các ký tự một cách tự nhiên và nó sẽ xử lý những gì cần được chuyển đổi.nếu bạn dùng & Một ký tự là một phần của thực thể ký tự HTML, nó được giữ nguyên, nếu không nó sẽ được chuyển đổi thành &;.
Vì vậy, nếu bạn muốn chèn một biểu tượng bản quyền trong tài liệu ©, bạn có thể viết:
©
Markdown sẽ để nguyên.Và nếu bạn viết:
AT&T
Markdown sẽ chuyển đổi nó thành:
AT&T
Tình huống tương tự cũng xảy ra ở < ký hiệu, vì Markdown cho phép khả năng tương thích HTML, nếu bạn đặt < Các ký hiệu được sử dụng làm dấu phân cách cho các thẻ HTML và Markdown sẽ không thực hiện bất kỳ chuyển đổi nào trên chúng, nhưng nếu bạn viết:
4 < 5
Markdown sẽ chuyển đổi nó thành:
4 < 5
Tuy nhiên, cần lưu ý rằng trong phạm vi mã, cho dù là nội tuyến hay khối, < Và & cả hai biểu tượngchắc chắnsẽ được chuyển đổi thành các thực thể HTML, một tính năng cho phép bạn dễ dàng viết mã HTML trong Markdown (trái ngược với HTML, nơi bạn đặt tất cả < Và & Tất cả được chuyển đổi thành các thực thể HTML, để viết mã HTML trong tệp HTML. )
phần tử khối
Các đoạn và ngắt dòng
Một đoạn Markdown bao gồm một hoặc nhiều dòng văn bản liên tiếp, đứng trước và theo sau bởi nhiều hơn một dòng trống (định nghĩa của một dòng trống là nó dường như trống trên màn hình và được coi là một dòng trống. Ví dụ: , nếu một dòng chỉ chứa khoảng trắng và tab, dòng đó cũng sẽ được coi là dòng trống).Các đoạn văn bình thường không được thụt lề với khoảng trắng hoặc tab.
Cụm từ "bao gồm một hoặc nhiều dòng văn bản liên tiếp" thực sự ngụ ý rằng Markdown cho phép bắt buộc ngắt dòng (chèn dòng mới) trong các đoạn văn, một tính năng khác với hầu hết các định dạng chuyển văn bản sang HTML khác (bao gồm cả Loại có thể di chuyển "Dòng chuyển đổi Tùy chọn ngắt "), các định dạng khác sẽ chuyển đổi từng ngắt dòng thành <br /> nhãn.
如果 你thậtMuốn dựa vào Markdown để chèn <br /> Đối với nhãn, hãy nhấn hai hoặc nhiều khoảng trắng tại vị trí chèn rồi nhấn Enter.
Thật vậy, phải mất thêm một chút công việc (không gian bổ sung) để tạo <br /> , nhưng chỉ đơn giản là "mỗi dòng mới được chuyển đổi thành <br />"Phương pháp này không phù hợp trong Markdown, em trong MarkdownaiDấu ngoặc kép kiểu chữ L và danh sách nhiều đoạn văn không chỉ hữu ích hơn mà còn dễ đọc hơn khi sắp chữ có ngắt dòng.
Tiêu đề
Markdown hỗ trợ hai cú pháp cho tiêu đề, giống Setext và giống atx.
Biểu mẫu giống Settext là biểu mẫu có dòng dưới cùng, sử dụng = (danh hiệu cao nhất) và - (Tiêu đề thứ hai), ví dụ:
This is an H1
=============
This is an H2
-------------
số lượng bất kỳ = Và - có thể hiệu quả.
Biểu mẫu giống Atx chèn từ 1 đến 6 ở đầu dòng # , tương ứng với các tiêu đề từ 1 đến 6, ví dụ:
# 这是 H1
## 这是 H2
###### 这是 H6
Bạn có thể tùy chọn "đóng" các tiêu đề giống atx, điều này hoàn toàn là để thẩm mỹ, nếu bạn cảm thấy thoải mái với cách này, bạn có thể thêm nó vào cuối dòng #, trong khi dòng kết thúc # Số không nhất thiết phải giống với phần đầu (số ký tự pound ở đầu dòng xác định thứ tự của tiêu đề):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Dấu ngoặc kép Những câu chuyện cổ tích
Dấu ngoặc kép đánh dấu đánh dấu được sử dụng tương tự như được sử dụng trong email > trích dẫn.Nếu bạn vẫn quen thuộc với dấu ngoặc kép trong thư email, bạn biết cách tạo dấu ngoặc kép trong tệp Markdown, trông giống như bạn tự ngắt dòng, sau đó thêm > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
Markdown cũng cho phép bạn lười biếng và chỉ thêm dòng đầu tiên của toàn bộ đoạn văn > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
Các tham chiếu khối có thể được lồng vào nhau (ví dụ: tham chiếu trong các tham chiếu) bằng cách thêm một số > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
Các cú pháp Markdown khác cũng có thể được sử dụng trong các khối được trích dẫn, bao gồm tiêu đề, danh sách, khối mã, v.v.:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
Bất kỳ trình soạn thảo văn bản tốt nào cũng có thể dễ dàng tạo các trích dẫn theo phong cách email.Ví dụ trong BBEdit, bạn có thể chọn văn bản và sau đó chọn từ menutăng hệ thống phân cấp trích dẫn.
Danh sách
Markdown hỗ trợ danh sách có thứ tự và không có thứ tự.
Danh sách không có thứ tự sử dụng dấu hoa thị, dấu cộng hoặc dấu trừ làm điểm đánh dấu danh sách:
* Red
* Green
* Blue
Tương đương với:
+ Red
+ Green
+ Blue
Cũng tương đương với:
- Red
- Green
- Blue
Danh sách có thứ tự sử dụng các số theo sau là dấu chấm:
1. Bird
2. McHale
3. Parish
Điều quan trọng cần lưu ý là các số bạn sử dụng trên thẻ danh sách không ảnh hưởng đến HTML đầu ra. Đánh dấu HTML kết quả cho danh sách trên sẽ là:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
Nếu đánh dấu danh sách của bạn được viết là:
1. Bird
1. McHale
1. Parish
hoặc thậm chí:
3. Bird
1. McHale
8. Parish
Cả hai bạn sẽ nhận được chính xác cùng một đầu ra HTML.Vấn đề là, bạn có thể làm cho số danh sách trong tệp Markdown giống với kết quả đầu ra, hoặc nếu lười biếng, bạn không cần quan tâm đến tính đúng đắn của các con số.
Nếu bạn sử dụng cách viết lười biếng, bạn nên bắt đầu bằng 1. cho mục đầu tiên, vì Markdown có thể hỗ trợ thuộc tính bắt đầu của danh sách có thứ tự trong tương lai.
Thẻ mục danh sách thường được đặt ở ngoài cùng bên trái, nhưng nó có thể được thụt vào, tối đa 3 dấu cách và thẻ mục phải được theo sau bởi ít nhất một dấu cách hoặc tab.
Để làm cho danh sách trông đẹp hơn, bạn có thể sắp xếp nội dung với một thụt lề cố định:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
Nhưng nếu bạn lười biếng, điều đó cũng tốt:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
Nếu các mục danh sách được phân tách bằng các dòng trống, Markdown sẽ sử dụng nội dung mục khi xuất HTML. <p> Các nhãn được bao bọc, ví dụ:
* Bird
* Magic
sẽ được chuyển đổi thành:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
Nhưng điều này:
* Bird
* Magic
sẽ được chuyển đổi thành:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
Các mục trong danh sách có thể chứa nhiều đoạn văn và các đoạn dưới mỗi mục phải được thụt lề bằng 4 dấu cách hoặc 1 tab:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
Tất nhiên, sẽ tốt hơn rất nhiều nếu bạn thụt lề từng dòng, một lần nữa, nếu bạn lười biếng, Markdown cũng cho phép:
* This is a list item with two paragraphs.
This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
* Another item in the same list.
Nếu bạn muốn đặt một tham chiếu bên trong một mục danh sách, thì > Nó cần được thụt vào:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
Nếu bạn muốn đặt một khối mã, khối đó cần được thụt lềhai lần, là 8 dấu cách hoặc 2 tab:
* 一列表项包含一个列表区块：
<代码写在这>
Tất nhiên, một danh sách các mục có thể được tạo ra một cách vô tình, giống như sau:
1986. What a great season.
Nói cách khác, nó xuất hiện ở đầu dòngsố-dấu chấm-trống, để tránh điều này, bạn có thể thêm dấu gạch chéo ngược trước dấu chấm.
1986\. What a great season.
khối mã
Mã nguồn ngôn ngữ thẻ hoặc văn bản liên quan đến chương trình thường có các khối mã đã được sắp chữ. Thông thường, chúng tôi không muốn các khối này được sắp chữ theo cách của các tệp đoạn văn chung, mà hiển thị chúng như cũ. Markdown sẽ sử dụng <pre> Và <code> các thẻ để bọc các khối mã.
Để tạo các khối mã trong Markdown chỉ đơn giản là thụt lề 4 dấu cách hoặc 1 tab, ví dụ: nhập như sau:
这是一个普通段落：
这是一个代码区块。
Markdown sẽ chuyển đổi thành:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
Thụt lề bậc nhất này trên mỗi dòng (4 dấu cách hoặc 1 tab) bị loại bỏ, ví dụ:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
sẽ được chuyển đổi thành:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
Một khối mã tiếp tục cho đến dòng không có dấu (hoặc cuối tệp).
Bên trong khối mã, & , < Và > Nó sẽ được tự động chuyển đổi thành các thực thể HTML. Phương pháp này giúp bạn rất dễ dàng sử dụng Markdown để chèn mã nguồn HTML cho ví dụ, chỉ cần sao chép và dán nó, thêm thụt lề và phần còn lại Markdown sẽ xử lý nó cho bạn, đối với thí dụ:
<div class="footer">
© 2004 Foo Corporation
</div>
sẽ được chuyển đổi thành:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
Trong khối mã, cú pháp Markdown chung sẽ không được chuyển đổi, chẳng hạn như dấu hoa thị chỉ là dấu hoa thị, có nghĩa là bạn có thể dễ dàng viết các tệp liên quan đến cú pháp Markdown theo cú pháp Markdown.
dải phân cách
Bạn có thể sử dụng nhiều hơn ba dấu hoa thị, dấu trừ, dấu gạch dưới để tạo dải phân cách trong một dòng, không có gì khác trong dòng.Bạn cũng có thể chèn dấu cách giữa các dấu sao hoặc dấu trừ.Các dòng phân cách có thể được tạo theo từng cách viết sau:
* * *
***
*****
- - -
---------------------------------------
phần tử
Liên kết
Markdown hỗ trợ hai dạng cú pháp liên kết: Nội tuyếnVàTài liệu tham khảohai hình thức.
Dù bằng cách nào, văn bản liên kết được đánh dấu bằng [dấu ngoặc vuông].
để tạo ra mộtNội tuyếnNếu bạn muốn thêm văn bản tiêu đề của liên kết, chỉ cần đặt văn bản tiêu đề bằng dấu ngoặc kép sau URL, ví dụ:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
Sẽ sản xuất:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
Nếu bạn đang liên kết đến các tài nguyên trên cùng một máy chủ, bạn có thể sử dụng các đường dẫn tương đối:
See my [About](/about/) page for details.
Tài liệu tham khảoLiên kết được theo sau bởi một dấu ngoặc vuông khác sau dấu ngoặc vuông của văn bản liên kết và dấu dùng để xác định liên kết phải được điền vào dấu ngoặc vuông thứ hai:
This is [an example][id] reference-style link.
Bạn cũng có thể tùy chọn đặt khoảng trắng giữa hai dấu ngoặc vuông:
This is [an example] [id] reference-style link.
Sau đó, ở bất kỳ đâu trong tệp, bạn có thể xác định nội dung liên kết của thẻ này:
[id]: http://example.com/ "Optional Title Here"
Nội dung liên kết được xác định dưới dạng:
- Dấu ngoặc vuông (tùy chọn đứng trước tối đa ba dấu cách để thụt lề) mà văn bản liên kết được nhập vào
- tiếp theo là dấu hai chấm
- theo sau là một hoặc nhiều dấu cách hoặc tab
- URL của liên kết tiếp theo
- Theo tùy chọn nội dung tiêu đề, có thể được đặt trong dấu ngoặc kép, dấu ngoặc kép hoặc dấu ngoặc đơn
Định nghĩa của ba liên kết sau là giống nhau:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
Xin lưu ý:Có một vấn đề đã biết khi Markdown.pl 1.0.1 bỏ qua các tiêu đề liên kết nằm trong dấu ngoặc kép.
URL liên kết cũng có thể được đặt trong dấu ngoặc nhọn:
[id]: <http://example.com/> "Optional Title Here"
Bạn cũng có thể đặt thuộc tính title trên dòng tiếp theo hoặc thêm một số thụt lề, sẽ đẹp hơn nếu URL quá dài:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
Định nghĩa URL chỉ được sử dụng khi tạo liên kết và không xuất hiện trực tiếp trong tệp.
Các thẻ nhận dạng liên kết có thể chứa các chữ cái, số, khoảng trắng và dấu câu, nhưng khôngKhôngNó phân biệt chữ hoa chữ thường, vì vậy hai liên kết sau giống nhau:
[link text][a]
[link text][A]
Thẻ liên kết ngầmtính năng cho phép bạn bỏ qua việc chỉ định thẻ liên kết. Trong trường hợp này, thẻ liên kết sẽ được coi là tương đương với văn bản liên kết. Để sử dụng thẻ liên kết ẩn, chỉ cần thêm một dấu ngoặc vuông trống sau văn bản liên kết. Nếu bạn muốn "Google " Liên kết với google.com, bạn có thể đơn giản hóa thành:
[Google][]
Sau đó xác định nội dung liên kết:
[Google]: http://google.com/
Vì văn bản liên kết có thể chứa khoảng trắng, đánh dấu đơn giản này có thể chứa nhiều từ:
Visit [Daring Fireball][] for more information.
Sau đó, tiếp tục xác định liên kết:
[Daring Fireball]: http://daringfireball.net/
Định nghĩa của liên kết có thể được đặt ở bất kỳ đâu trong tệp. Tôi thích đặt nó ngay sau đoạn mà liên kết xuất hiện. Bạn cũng có thể đặt nó ở cuối tệp, giống như một nhận xét.
Đây là một ví dụ về liên kết tham chiếu:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
Nếu bạn thay đổi nó để sử dụng tên liên kết để viết:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
Hai cách viết trên sẽ tạo ra HTML sau.
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
Dưới đây là tệp Markdown có cùng nội dung được viết nội tuyến, được cung cấp để so sánh:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
Trên thực tế, điểm của các liên kết kiểu tham chiếu không phải là nó dễ viết hơn mà là nó dễ đọc hơn. Hãy so sánh ví dụ trên. Bản thân bài viết kiểu tham chiếu chỉ có 81 ký tự, nhưng dạng nội tuyến sẽ tăng lên 176 ký tự., Nếu nó được viết ở định dạng HTML thuần túy, sẽ có 234. Ở định dạng HTML, có nhiều thẻ hơn là văn bản.
Sử dụng các liên kết kiểu tham chiếu của Markdown, bạn có thể làm cho tài liệu giống kết quả cuối cùng của trình duyệt hơn, cho phép bạn di chuyển một số siêu dữ liệu liên quan đến đánh dấu ra bên ngoài văn bản đoạn văn và bạn có thể thêm liên kết mà không làm cho việc đọc bài viết bị gián đoạn .
强调
Markdown sử dụng dấu hoa thị (*) và điểm mấu chốt (_) như một biểu tượng để đánh dấu một từ được gạch chân, là * 或 _ Các từ xung quanh được chuyển đổi thành <em> được bao quanh bởi các nhãn, với hai * 或 _Nếu nó được bao bọc, nó sẽ được chuyển đổi thành <strong>,Ví dụ:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
sẽ biến thành:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
Bạn có thể sử dụng bất kỳ phong cách nào bạn thích, hạn chế duy nhất là bạn có thể sử dụng biểu tượng để mở thẻ và biểu tượng để kết thúc thẻ.
Nhấn mạnh cũng có thể được chèn trực tiếp vào giữa văn bản:
un*frigging*believable
nhưngnếu là của bạn * Và _ Nếu có khoảng trắng ở cả hai bên, chúng chỉ được coi là biểu tượng bình thường.
Để chèn dấu hoa thị hoặc dấu gạch dưới bình thường trực tiếp trước và sau văn bản, bạn có thể sử dụng dấu gạch chéo ngược:
\*this text is surrounded by literal asterisks\*
Mã
Nếu bạn muốn đánh dấu một đoạn mã nội tuyến nhỏ, bạn có thể bọc nó trong dấu gạch ngược (`),Ví dụ:
Use the `printf()` function.
Sẽ sản xuất:
<p>Use the <code>printf()</code> function.</p>
Nếu bạn muốn chèn dấu gạch ngược bên trong phần mã, bạn có thể bắt đầu và kết thúc phần mã bằng nhiều dấu gạch ngược:
``There is a literal backtick (`) here.``
Cú pháp này tạo ra:
<p><code>There is a literal backtick (`) here.</code></p>
Bạn có thể đặt một ô trống ở đầu và cuối phần mã, một ô sau phần đầu và một ô trống trước phần cuối, vì vậy bạn có thể chèn dấu gạch ngược vào đầu phần:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
Sẽ sản xuất:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
Bên trong phần mã,& và dấu ngoặc nhọn都sẽ được tự động chuyển đổi thành các thực thể HTML, điều này giúp bạn dễ dàng chèn mã nguồn HTML, Markdown sẽ đặt đoạn sau:
Please don't use any `<blink>` tags.
đến:
<p>Please don't use any <code><blink></code> tags.</p>
Bạn cũng có thể viết như sau:
`—` is the decimal-encoded equivalent of `—`.
Để sản xuất:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
Rõ ràng, rất khó để thiết kế một cú pháp "tự nhiên" để chèn hình ảnh trong một ứng dụng chỉ có văn bản.
Markdown sử dụng cú pháp tương tự như liên kết để đánh dấu hình ảnh và cũng cho phép hai kiểu: Nội tuyếnVàTài liệu tham khảo.
Cú pháp hình ảnh nội tuyến trông giống như:
Chi tiết như sau:
- dấu chấm than
! - theo sau là một dấu ngoặc vuông với văn bản thay thế cho hình ảnh
- Tiếp theo là dấu ngoặc đơn bình thường với URL của hình ảnh và cuối cùng là văn bản 'tiêu đề' tùy chọn được đặt trong dấu ngoặc kép.
Cú pháp hình ảnh tham chiếu trông giống như sau:
![Alt text][id]
"id" là tên của tham chiếu hình ảnh, được xác định theo cách giống như tham chiếu liên kết:
[id]: url/to/image "Optional title attribute"
Cho đến nay, Markdown không có cách nào để chỉ định chiều rộng và chiều cao của hình ảnh, nếu cần, bạn có thể sử dụng bình thường <img> nhãn.
其它
liên kết tự động
Markdown hỗ trợ xử lý URL và email dưới dạng liên kết ngắn tự động, chỉ cần chúng được đặt trong dấu ngoặc nhọn, Markdown sẽ tự động chuyển nó thành liên kết.Văn bản liên kết của URL chung giống với địa chỉ liên kết, ví dụ:
<http://example.com/>
Markdown sẽ được chuyển đổi thành:
<a href="http://example.com/">http://example.com/</a>
Việc liên kết tự động các địa chỉ email cũng tương tự, ngoại trừ việc Markdown trước tiên sẽ thực hiện quá trình chuyển đổi mã hóa, chuyển đổi các ký tự văn bản thành các thực thể HTML hệ thập lục phân. Định dạng này có thể đánh lừa một số rô bốt thu thập địa chỉ email xấu, chẳng hạn như:
<[email protected]>
Markdown sẽ chuyển thành:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
Trong trình duyệt, chuỗi này (thực sự <a href="mailto:[email protected]">[email protected]</a>) trở thành liên kết "[email protected]" có thể nhấp.
(Mặc dù cách tiếp cận này có thể đánh lừa rất nhiều robot, nhưng nó không thể ngăn chặn tất cả, nhưng còn hơn không. Trong mọi trường hợp, việc mở hộp thư của bạn cuối cùng sẽ thu hút được thư quảng cáo).
dấu gạch chéo ngược
Markdown có thể sử dụng dấu gạch chéo ngược để chèn một số ký hiệu có nghĩa khác trong ngữ pháp, ví dụ: nếu bạn muốn thêm dấu hoa thị bên cạnh văn bản để nhấn mạnh (nhưng không <em> ), bạn có thể đặt trước dấu hoa thị bằng dấu gạch chéo ngược:
\*literal asterisks\*
Markdown hỗ trợ các ký hiệu sau có dấu gạch chéo ngược để giúp chèn các ký hiệu phổ biến:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Trình chỉnh sửa miễn phí Markdown
Nền tảng Windows
Nền tảng Mac
biên tập viên trực tuyến
plugin trình duyệt
*** Nếu có trình chỉnh sửa Markdown miễn phí tốt hơn để giới thiệu, vui lòng chú ý đến phản hồiChen Weiliang,cảm ơn!
Hy vọng Chen Weiliang Blog ( https://www.chenweiliang.com/ ) đã chia sẻ “Markdown nghĩa là gì? Làm thế nào để sử dụng cú pháp Markdown / đánh dấu định dạng? , để giúp bạn.
Chào mừng bạn đến chia sẻ liên kết của bài viết này:https://www.chenweiliang.com/cwl-482.html