Cú pháp Markdown Hỗ trợ

Khả năng render hoàn hảo các tài liệu kỹ thuật chính là nơi Obsidian-style Markdown Editor tỏa sáng nhất. Kế thừa triết lý của Obsidian, công cụ này không chỉ dừng lại ở Markdown cơ bản (GFM) mà còn mở rộng hỗ trợ nhiều cú pháp nâng cao.

1. Khối lưu ý (Admonitions)

Tạo điểm nhấn cho tài liệu bằng các khối lưu ý, cảnh báo (Note, Tip, Warning, Caution, Important) theo chuẩn GitHub. Các khối này tự động hiển thị với màu sắc và biểu tượng đặc trưng, giúp người đọc nắm bắt thông tin quan trọng một cách trực quan.

Bạn có thể chèn nhanh thông qua menu Admonition trên Toolbar hoặc gõ cú pháp:

> [!NOTE]
> Thông tin bổ sung hữu ích.

> [!WARNING]
> Cảnh báo quan trọng cần lưu ý.

2. Toán học và Phương trình (LaTeX)

Được trợ lực bởi thư viện KaTeX mạnh mẽ, các công thức toán học nội tuyến (inline) hay dạng khối (block) đều được hiển thị sắc nét. Bạn không còn phải căng mắt đọc các đoạn mã \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} mà sẽ thấy ngay công thức hiển thị chuẩn mực như trên mặt báo học thuật.

Chỉ cần bao quanh công thức bằng $inline$ hoặc $$block$$.

3. Biểu đồ Thông minh (Mermaid)

Thay vì phải dùng công cụ vẽ bên ngoài và chèn ảnh tĩnh, bạn có thể phác thảo kiến trúc hệ thống trực tiếp bằng mã Mermaid. Khối mã sẽ được render thành biểu đồ ngay lập tức.

Cần sửa đổi? Chỉ cần nhấp đúp vào biểu đồ trong chế độ Live Mode để quay lại chỉnh sửa mã nguồn của nó. Hệ thống tự động thay đổi giao diện biểu đồ dựa trên theme sáng/tối của VS Code.

4. Bảng biểu Linh hoạt

Bảng trong Markdown thuần thường là "cơn ác mộng" canh chỉnh. Với Live Editor:

• Chỉnh sửa trực quan: Bạn có thể dùng trình đơn ngữ cảnh (chuột phải) để Thêm cột/dòng, Xóa cột/dòng, hoặc Xóa bảng một cách dễ dàng.
• Thích ứng giao diện: Hỗ trợ hai chế độ xem thông minh (cấu hình qua markdownLive.tableDisplayMode). Bạn có thể chọn cuộn ngang (scroll) bảo toàn cấu trúc dữ liệu, hoặc bọc văn bản (wrap) để bảng tự động thu gọn vừa màn hình.

5. Tương tác HTML và Metadata (YAML)

• HTML Tương tác: Hỗ trợ render native các thẻ HTML nhúng, điển hình là <details> và <summary>. Bạn có thể tương tác trực tiếp (đóng/mở) ngay trong lúc soạn thảo.
• Properties (YAML Frontmatter): Phần siêu dữ liệu ở đầu file (bao bọc bởi ---) được tách biệt thành một khu vực giao diện rõ ràng, hiện đại. Bạn có thể dễ dàng quản lý thuộc tính (title, date, tags) mà không sợ làm bẩn nội dung bài viết.

6. Khối Mã nguồn, Wikilinks & Footnotes

• Code Blocks: Được highlight cú pháp mượt mà, biến tài liệu API hay hướng dẫn lập trình trở nên sinh động và chuyên nghiệp.
• Wikilinks & Hashtag: Hỗ trợ cú pháp liên kết nội bộ [[tên file]] và thẻ hashtag #tag – hai thành phần cốt lõi xây dựng Zettelkasten cá nhân tương tự như Obsidian.
• Footnotes (Chú thích dưới trang): Chèn nhanh chỉ số trên [^1] và định nghĩa chú thích ở cuối bài, phù hợp cho bài viết học thuật.

7. Hệ thống Template (Chuẩn Obsidian Templater)

Obsidian-style Markdown Editor tích hợp hệ thống chèn mẫu (Template) mạnh mẽ, được thiết kế để tương thích ngược với các cú pháp phổ biến của Templater trong Obsidian.

Để sử dụng, bạn cần chỉ định thư mục chứa file mẫu trong cài đặt markdownLive.templateFolder (ví dụ .vscode/templates).

Các Placeholder được hỗ trợ: