Markdown là một định dạng viết; HTML là một định dạng xuất bản. Do đó, cú pháp Markdown không nhằm cung cấp tính linh hoạt hoàn toàn của HTML, mà chỉ là các phần tử phổ biến nhất cho văn bản. Khi cần thực hiện một thao tác phức tạp hơn, bạn có thể sử dụng bất kỳ thẻ HTML cùng dòng và thẻ cấp khối nào được DevSite hỗ trợ trong tệp Markdown. Bạn không cần cho biết rằng bạn đang chuyển từ Markdown sang HTML, chỉ cần sử dụng thẻ HTML như trong ví dụ bên dưới.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML cùng dòng
Thẻ HTML cùng dòng có thể được dùng trong đoạn văn Markdown, mục danh sách hoặc tiêu đề và các thẻ này cũng có thể chứa cú pháp Markdown (ví dụ: **strong**, *emphasis*, v.v.) Việc này rất hữu ích khi bạn muốn thu hút sự chú ý vào một đoạn mã, như trong ví dụ dưới đây.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML cấp khối
Các thẻ HTML cấp khối mà DevSite hỗ trợ phải được tách khỏi nội dung xung quanh bằng một dòng trống. Ngoài ra, không giống như thẻ HTML cùng dòng, cú pháp Markdown (ví dụ: **strong**, *emphasis*, v.v.) trong thẻ HTML cấp khối không được hiển thị như trong ví dụ bên dưới.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Các phương pháp hay nhất
Bạn nên định dạng HTML trong tệp Markdown theo các cách sau để tránh lỗi hiển thị trên DevSite.
Đừng dùng thẻ HTML cấp khối không được hỗ trợ DevSite hỗ trợ nhiều thẻ HTML cấp khối; nhưng việc thêm URL không được hỗ trợ sẽ hiển thị HTML của bạn dưới dạng văn bản hoặc phá vỡ mã.
Không thêm thẻ hoặc dấu cách thừa khi thụt lề Không được thụt lề thẻ mở và thẻ kết thúc ở cấp khối bằng thẻ hoặc dấu cách. Một số trình chỉnh sửa tự động thêm các thẻ hoặc dấu cách thừa — hãy cẩn thận!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Đừng quên rằng mã không thụt lề là mã tương đối
Ví dụ: bạn không cần thụt lề thẻ bắt đầu và thẻ kết thúc ở cấp khối khi tạo danh sách trong Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Đừng thêm dòng trống giữa thẻ mở và thẻ đóng
Việc này rất dễ thực hiện khi bạn chuyển đổi giữa Markdown và HTML, nhưng một dòng trống đơn giản có thể dễ dàng hiển thị trang không chính xác.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.