Trợ giúp
Markzen là gì?
Markzen là một trình soạn thảo máy tính để bàn dành cho ngôn ngữ đánh dấu nhẹ — Markdown và sáu ngôn ngữ khác — với bản xem trước trực tiếp, được định kiểu đầy đủ. Bạn viết văn bản thuần túy được đánh dấu bằng dấu câu đơn giản ở bên trái và Markzen sẽ hiển thị nó dưới dạng HTML được định dạng ở bên phải khi bạn nhập.
Điều làm nên sự khác biệt so với trình soạn thảo Markdown thông thường là khả năng chuyển đổi hai chiều. Markzen đọc tám ngôn ngữ đánh dấu, hiển thị 30 tiện ích mở rộng trực tiếp (sơ đồ, biểu đồ, công thức toán học, bản nhạc, bàn cờ, mã QR) bên trong tài liệu và xuất ra hơn hai mươi định dạng — sách điện tử, Word, PowerPoint, LaTeX, sổ ghi chép Jupyter và nhiều hơn nữa. Viết một lần, chuyển kết quả thành hầu hết mọi thứ. Bộ chuyển đổi được tích hợp sẵn, vì vậy không cần cài đặt công cụ bên ngoài.
Bạn có thể mở một tệp hiện có hoặc chỉ cần bắt đầu nhập — không có yêu cầu phải mở tệp trước.
Trình chỉnh sửa
Ngăn bên trái là một trình chỉnh sửa mã CodeMirror đầy đủ, không phải hộp văn bản thuần túy: nó có tính năng tô sáng cú pháp cho ngôn ngữ đánh dấu bạn đang viết, một thanh công cụ định dạng (in đậm, in nghiêng, tiêu đề, danh sách và nhiều hơn nữa, cộng với các nút chuyên dụng để chèn liên kết và hình ảnh — xem Liên kết & hình ảnh — và để chèn bảng, xem Bảng & bảng tính), và tìm kiếm thay thế. Các phím tắt chỉnh sửa tiêu chuẩn — sao chép, dán, hoàn tác, làm lại — hoạt động như bạn mong đợi.
Bạn viết bằng một trong tám ngôn ngữ đánh dấu nhẹ. Đây là các định dạng văn bản thuần túy thể hiện cấu trúc bằng dấu câu (# cho tiêu đề, * cho nhấn mạnh) thay vì kiểu ẩn, vì vậy tài liệu vẫn dễ đọc dưới dạng văn bản và thân thiện với việc so sánh trong kiểm soát phiên bản. Markzen đọc cả tám và quyết định tệp thuộc ngôn ngữ nào dựa trên phần mở rộng của nó — bạn không bao giờ chọn định dạng thủ công. Khả năng tương thích liệt kê các phần mở rộng mở ngôn ngữ nào.
Mỗi ngôn ngữ có các quy ước riêng và hệ sinh thái tài liệu hiện có của riêng nó; Markzen hiển thị mỗi ngôn ngữ theo phương ngữ riêng của nó thay vì chuyển đổi mọi thứ sang Markdown trước. BBCode là ngôn ngữ không có một tiêu chuẩn duy nhất — mỗi diễn đàn đã phát minh ra biến thể riêng của mình — vì vậy Markzen đọc nó một cách rộng rãi, chấp nhận các cách viết phổ biến song song ([list] hoặc [ul], [h1] hoặc [heading=1]) và để bất kỳ thẻ nào nó không nhận ra hiển thị dưới dạng văn bản thuần túy thay vì nuốt nó. Để chuyển loại ngôn ngữ đánh dấu mà tài liệu được viết, hãy sử dụng menu Chuyển đổi sang của thanh công cụ (xem Chuyển đổi & xuất bên dưới).
Không phải mọi ngôn ngữ đều có thể thể hiện mọi thứ. Thanh công cụ định dạng mang các nút giống nhau trong mọi tài liệu, nhưng Markzen chỉ viết ngôn ngữ đánh dấu mà ngôn ngữ đó tự định nghĩa — nó không bao giờ phát minh ra một phương ngữ riêng để lấp đầy khoảng trống. Một nút mà ngôn ngữ hiện tại không có ký hiệu sẽ bị làm mờ. In đậm, in nghiêng, tiêu đề, danh sách, khối mã, liên kết, hình ảnh, quy tắc và bảng có sẵn trong cả tám; một số ít khoảng trống được liệt kê trong Khả năng tương thích. Markdown là ngôn ngữ gây ngạc nhiên cho mọi người: nó không có cách tiêu chuẩn để căn giữa một đoạn văn, vì vậy Markzen không cung cấp các nút căn chỉnh ở đó thay vì viết thứ mà chỉ một số người đọc sẽ tôn trọng.
Kích thước văn bản được đặt bằng các nút Phóng to chữ và Thu nhỏ chữ của thanh công cụ. Ngăn chỉnh sửa cũng có thể được ẩn hoàn toàn — khi đó, Markzen trở thành một trình đọc thuần túy (xem Xem trước trực tiếp).
Liên kết & hình ảnh
Thanh công cụ định dạng có hai nút chuyên dụng để đưa liên kết hoặc hình ảnh vào tài liệu, và mỗi nút sẽ mở một cửa sổ bật lên nhỏ ngay tại vị trí con trỏ của bạn. Liên kết (Ctrl+K) — hoặc nhấn Ctrl+K — chèn một siêu liên kết: nhập văn bản liên kết và địa chỉ của nó, và Markzen sẽ viết đánh dấu chính xác cho nó. Hình ảnh chèn một hình ảnh theo cùng một cách, với một vài lựa chọn bổ sung được đề cập dưới đây.
Cả hai đều được viết bằng đánh dấu mà tài liệu hiện tại sử dụng — một liên kết được chèn vào tệp AsciiDoc sẽ xuất hiện dưới dạng AsciiDoc, vào tệp Org dưới dạng Org, và cứ thế trên tất cả tám ngôn ngữ.
Bắt đầu từ một địa chỉ bạn đã có. Dán một địa chỉ web vào tài liệu, chọn nó, và nhấn Ctrl+K: Markzen thấy rằng lựa chọn là một địa chỉ chứ không phải từ ngữ, đặt nó vào trường địa chỉ của cửa sổ bật lên và để con trỏ trong trường văn bản trống, chờ đợi nội dung mà liên kết nên nói. Nếu không có điều đó, một địa chỉ đã chọn sẽ trở thành văn bản hiển thị của liên kết — một liên kết đọc như một URL trần. Đường dẫn tệp tuyệt đối cũng được tính là địa chỉ, trên Windows và các nơi khác, vì vậy cùng một phím tắt sẽ biến một đường dẫn đã dán thành một liên kết đến tệp đó.
Chỉnh sửa một liên kết hoặc hình ảnh bạn đã có. Đặt con trỏ bất cứ đâu trên một liên kết hoặc hình ảnh hiện có và mở lại cửa sổ bật lên (nút, hoặc Ctrl+K): Markzen nhận ra cấu trúc, tải văn bản và địa chỉ hiện tại của nó vào cửa sổ bật lên, và thay thế toàn bộ khi bạn xác nhận — vì vậy bạn chỉnh sửa nó tại chỗ thay vì vô tình lồng một liên kết mới vào bên trong liên kết cũ.
Đối với hình ảnh, cửa sổ bật lên cũng cung cấp nút Tìm hình ảnh để chọn một tệp từ đĩa thay vì gõ đường dẫn — nó mở trong thư mục bạn đã lấy hình ảnh lần cuối, được giữ riêng biệt với thư mục mà tài liệu của bạn đến từ — và một lựa chọn quan trọng: liệu hình ảnh được nhúng hay liên kết.
Hình ảnh nhúng hoặc liên kết
Khi bạn chèn một hình ảnh, Markzen có thể lưu trữ nó trong tài liệu theo hai cách:
- Đã liên kết — tài liệu chỉ trỏ đến hình ảnh, bằng đường dẫn tệp hoặc địa chỉ web. Tệp tài liệu vẫn nhỏ, nhưng hình ảnh phải đi kèm với nó (hoặc vẫn có thể truy cập được tại URL của nó), nếu không nó sẽ không hiển thị ở nơi khác. Đây là mặc định.
- Đã nhúng — các byte thực tế của hình ảnh được ghi vào tài liệu dưới dạng văn bản (một khối
data:base64), vì vậy tệp hoàn toàn tự chứa: một tệp mang mọi thứ, không có gì để mất dấu. Đánh đổi là kích thước — tài liệu tăng lên theo trọng lượng của hình ảnh, và một hình ảnh nhúng không thể sử dụng đường dẫn tương đối.
Chọn Nhúng khi bạn muốn một tệp di động duy nhất để chuyển giao; chọn Liên kết khi bạn giữ hình ảnh bên cạnh tài liệu và muốn tệp vẫn nhỏ.
Đối với một hình ảnh được liên kết, một tùy chọn nữa xuất hiện: Đường dẫn tương đối. Khi hình ảnh nằm trong thư mục của tài liệu (hoặc một thư mục con), việc đánh dấu tùy chọn này sẽ viết tham chiếu dưới dạng đường dẫn tương đối ngắn thay vì đường dẫn tuyệt đối đầy đủ, vì vậy liên kết vẫn hoạt động khi bạn di chuyển tài liệu và hình ảnh của nó cùng nhau. Nó chỉ được cung cấp khi hình ảnh nằm trong thư mục của tài liệu — nếu không thì không có đường dẫn tương đối nào để viết.
Hình ảnh nhúng vẫn gọn gàng trong trình chỉnh sửa. Một hình ảnh nhúng base64 là một bức tường văn bản dài mà nếu không sẽ chôn vùi các dòng xung quanh nó, vì vậy Markzen gấp mỗi hình ảnh thành một chip nhỏ hiển thị loại và kích thước của nó (ví dụ 🖼 webp · 38 KB). Chip chỉ hiển thị — văn bản cơ bản không bị chạm vào, vì vậy việc lưu, sao chép hoặc cắt luôn mang theo hình ảnh đầy đủ, và con trỏ bỏ qua chip như một đơn vị duy nhất.
Tệp, tab & lưu
Markzen cho phép bạn mở bao nhiêu tài liệu cùng lúc tùy thích, mỗi tài liệu trong một tab riêng, để bạn có thể làm việc trên nhiều tệp và chuyển đổi giữa chúng một cách tự do. Bạn không cần mở tệp để bắt đầu — hãy bắt đầu gõ vào tài liệu trống đã có sẵn, hoặc sử dụng các nút tệp trên thanh công cụ:
- Tài liệu mới — mở một menu ngắn (Tạo mới) liệt kê tám ngôn ngữ đánh dấu; chọn một để bắt đầu một tài liệu mới, trống được viết bằng ngôn ngữ đánh dấu đó, trong một tab mới.
- Mở tệp Markdown — duyệt tìm một tệp hiện có và mở nó. Trình chọn chấp nhận tất cả tám định dạng đánh dấu, và Markzen chọn đúng định dạng từ phần mở rộng của tệp. Nó mở trong thư mục bạn đã lấy tài liệu lần cuối, được ghi nhớ giữa các phiên, vì vậy bạn không phải bắt đầu lại từ đầu mỗi lần.
- Lưu — ghi tài liệu đang hoạt động trở lại tệp của nó. Một tài liệu chưa bao giờ được lưu sẽ chuyển sang Lưu dưới dạng để bạn có thể đặt tên cho nó trước.
- Lưu dưới dạng — lưu tài liệu đang hoạt động vào một tệp mới, giữ nguyên bản gốc.
Bạn cũng có thể kéo một tệp từ trình quản lý tệp của mình và thả nó vào cửa sổ để mở.
Mỗi tài liệu đang mở là một tab ở phía trên cùng của cửa sổ. Một tab chưa được lưu được đánh dấu bằng một dấu chấm, và một tab có ngôn ngữ đánh dấu không phải Markdown mang một huy hiệu định dạng nhỏ (ví dụ adoc). Dấu × trên một tab sẽ đóng nó — và việc đóng một tài liệu có các thay đổi chưa được lưu sẽ không bao giờ loại bỏ chúng một cách im lặng: một thanh nội tuyến xuất hiện trên tab để bạn có thể Lưu hoặc Bỏ qua trước.
Trong khi một tài liệu đang mở, Markzen theo dõi tệp của nó trên đĩa. Nếu tệp thay đổi trong một chương trình khác và bạn không có chỉnh sửa chưa được lưu của riêng mình, Markzen sẽ tự động kéo phiên bản mới; nếu bạn có chỉnh sửa chưa được lưu, nó sẽ hỏi trước — một thanh Tải lại nội tuyến cho phép bạn quyết định có nên lấy phiên bản trên đĩa hay giữ phiên bản của riêng bạn.
Xem trước trực tiếp
Ngăn bên phải là tài liệu được hiển thị dưới dạng HTML đã định kiểu, cập nhật trực tiếp khi bạn nhập. Các liên kết hoạt động, bảng được căn chỉnh, mã được hiển thị trong một khối đơn cách, danh sách tác vụ có hộp kiểm và mọi khối tiện ích mở rộng hiển thị (xem bên dưới) đều vẽ hình của nó vào đúng vị trí. Bản xem trước là một hình ảnh trung thực về giao diện của bản xuất HTML hoặc PDF.
Nếu một tài liệu Markdown mở bằng một khối tiền tố YAML — phần --- key: value --- mà các công cụ như Jekyll, Hugo và Obsidian đặt ở trên cùng — Markzen sẽ hiển thị nó dưới dạng một thẻ siêu dữ liệu gọn gàng phía trên tài liệu, thay vì để dấu --- đóng biến thành một tiêu đề lạc.
Chế độ bố cục
Một nhóm ba nút trên thanh công cụ đặt những gì cửa sổ hiển thị:
- Chế độ xem chia đôi — trình chỉnh sửa và xem trước cạnh nhau. Kéo bộ chia để thay đổi không gian mà mỗi bên nhận được.
- Hiện trình soạn thảo — chỉ trình chỉnh sửa, lấp đầy cửa sổ để viết không bị phân tâm.
- Hiện bản xem trước — chỉ xem trước, một trình đọc toàn chiều rộng sạch sẽ.
Mục lục
Nút Mục lục mở một bảng được xây dựng tự động từ mọi tiêu đề trong tài liệu (#, ##, ###, …). Nhấp vào bất kỳ mục nào để cuộn bản xem trước đến phần đó. Bất kỳ tiêu đề nào có tiêu đề phụ bên dưới nó đều hiển thị một dấu mũi tên: nhấp vào nó để Thu gọn phần đó và ẩn các tiêu đề lồng nhau của nó, hoặc Mở rộng để đưa chúng trở lại — để bạn có thể thu gọn một dàn ý dài xuống chỉ còn các phần bạn đang làm việc. Các nút nhỏ 2 / 3 / 4 trong tiêu đề bảng giới hạn dàn ý ở độ sâu tiêu đề đó — hữu ích trong một tài liệu dài khi bạn chỉ muốn xem các cấp trên cùng — và nhấp lại vào nút đang hoạt động sẽ đưa mọi cấp độ trở lại. Bảng thay đổi kích thước bằng cách kéo cạnh trái của nó và thu gọn để giải phóng không gian đọc. Nó chỉ là một công cụ hỗ trợ điều hướng bên trong ứng dụng — nó không bao giờ xuất hiện trong bản xuất.
Cung cấp dàn ý của riêng bạn. Nếu các tiêu đề không phải là dàn ý bạn muốn, một tài liệu có thể mang dàn ý của riêng nó. Một khối được bao quanh được gắn thẻ markzen có dòng đầu tiên là toc sẽ thay thế bảng được tạo bằng danh sách được viết bên dưới nó:
`markdown
```markzen
toc
- [Introduction](#intro)
- [Background](#background)
- [Results](#results)
```
Thụt lề đặt cấp độ và mỗi mục trỏ đến một neo phải tồn tại trong chính tài liệu — một tiêu đề bạn đã đặt id rõ ràng, hoặc một <a id="intro"></a> đơn giản. Bản thân khối không vẽ gì: nó là siêu dữ liệu mà bảng đọc.
Bảng & bảng tính
Bảng di chuyển dễ dàng giữa Markzen và bất kỳ bảng tính nào. Dán văn bản được phân tách bằng tab — sao chép từ Excel, Google Sheets, Word hoặc bảng web — vào trình chỉnh sửa và Markzen sẽ biến nó thành một bảng thích hợp được viết bằng ngôn ngữ đánh dấu của tài liệu, thay vì thả vào một bức tường các ký tự tab. Trình đọc dán nhận biết dấu ngoặc kép (nó xử lý đúng các ô tự chứa tab, ngắt dòng hoặc dấu ngoặc kép) và chỉ kích hoạt khi bảng tạm giữ một lưới hình chữ nhật sạch gồm ít nhất hai cột; bất cứ thứ gì khác sẽ dán dưới dạng văn bản thông thường.
Bạn cũng có thể bắt đầu một bảng từ đầu. Nút Chèn bảng trên thanh công cụ mở một lưới nhỏ — quét qua nó để chọn số hàng và cột bạn muốn, và Markzen sẽ viết một bảng trống có kích thước đó bằng ngôn ngữ đánh dấu của tài liệu, sẵn sàng để nhập. Hàng đầu tiên là hàng tiêu đề.
Điều ngược lại cũng hoạt động. Di chuột qua bất kỳ bảng được hiển thị nào trong bản xem trước và một nút sao chép sẽ xuất hiện ở góc của nó: nó sao chép bảng trở lại dưới dạng văn bản được phân tách bằng tab mà bạn có thể thả thẳng vào một ô bảng tính hoặc tài liệu Word. Các nút sao chép này chỉ là tiện ích xem trước — chúng bị loại bỏ khỏi mọi xuất và chuyển đổi, vì vậy một tệp được chia sẻ chỉ chứa bảng sạch.
Tiện ích mở rộng hiển thị
Markzen mở rộng đánh dấu tiêu chuẩn thông qua các khối mã được rào chắn. Thẻ ngôn ngữ ngay sau ba dấu gạch ngược mở quyết định cách khối hiển thị: một thẻ mà Markzen nhận dạng là tiện ích mở rộng sẽ vẽ một hình trực tiếp thay vì hiển thị mã.
Mỗi loại hình được vẽ bởi công cụ hiển thị riêng và Markzen tìm nạp một công cụ lần đầu tiên một tài liệu thực sự yêu cầu nó thay vì tải tất cả chúng khi khởi chạy — đó là lý do tại sao ứng dụng khởi động gần như ngay lập tức và tại sao sơ đồ đầu tiên của một loại nhất định có thể mất một lúc để xuất hiện trong khi mọi sơ đồ sau đó là ngay lập tức.
Ví dụ, nguồn này:
```mermaid
graph LR
A --> B --> C
```
hiển thị dưới dạng một biểu đồ luồng trực tiếp, không phải là một danh sách mã — và nó vẫn là một biểu đồ luồng trong các bản xuất PDF và HTML.
Sơ đồ, biểu đồ, toán học, ký hiệu âm nhạc, bàn cờ vua và cờ vây, mã QR và nhiều hơn nữa được tích hợp sẵn — Khả năng tương thích liệt kê từng loại với thẻ của nó.
Mỗi tiện ích mở rộng có thẻ ngôn ngữ riêng (mermaid, chartjs, katex, abc, chess, …). Bạn có thể kết hợp bao nhiêu tùy thích với văn xuôi thông thường trong một tài liệu duy nhất — tất cả chúng đều hiển thị cùng nhau. Việc một hình có còn là một hình sau khi tài liệu rời khỏi Markzen hay không phụ thuộc vào nơi bạn gửi nó — xem Chuyển đổi & xuất bên dưới.
Công thức trong một câu
Một công thức toán học có thể là một khối riêng — một khối katex hoặc asciimath, đứng một mình và căn giữa như một phương trình trong sách giáo khoa. Điều đó hoạt động trong cả tám ngôn ngữ đánh dấu.
Một công thức cũng có thể nằm trong một câu, để "diện tích là pi r bình phương" đọc như một dòng văn xuôi với các ký hiệu thực trong đó. Điều đó phụ thuộc vào ngôn ngữ đánh dấu có ký hiệu cho nó, và mỗi ngôn ngữ viết nó khác nhau — ký hiệu cho mỗi ngôn ngữ nằm trong Khả năng tương thích.
Textile và BBCode là hai ngoại lệ, và đó là giới hạn của các ngôn ngữ đó chứ không phải của Markzen: cả hai đều chưa bao giờ định nghĩa một cách để viết toán học. Trong một tài liệu Textile hoặc BBCode, một công thức do đó phải là một khối riêng. Không có gì bị mất — công thức hiển thị và nó tồn tại khi xuất — nó đơn giản là không thể được dệt vào một dòng văn xuôi.
Đặt và định cỡ một hình
Di chuột qua một hình đã hiển thị trong bản xem trước và một bảng nhỏ xuất hiện bên cạnh nó: các nút căn chỉnh (trái, giữa, phải) và — đối với các loại hình có thể thay đổi kích thước — các hộp chiều rộng và chiều cao theo pixel. remove style block xóa chúng một lần nữa.
Lựa chọn đó không được giữ ở đâu đó vô hình: bảng điều khiển ghi nó vào tài liệu, dưới dạng một khối ngắn được gắn thẻ markzen được đặt ngay trước hình mà nó áp dụng.
```markzen
style
align center
width 480
```
Vì vậy, bố cục đi kèm với tệp — nó là một phần của những gì bạn lưu, chuyển giao và xuất, trên bất kỳ máy nào. Bạn cũng có thể viết khối bằng tay: một chỉ thị trên mỗi dòng, align (left, center hoặc right), width và height theo pixel, luôn áp dụng cho khối ngay bên dưới nó.
Tạo kiểu cho một tài liệu bằng CSS
Một tài liệu Markdown cũng có thể mang bảng định kiểu riêng của nó, trong một khối được rào chắn được gắn thẻ style:
```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```
Các quy tắc áp dụng cho bản xem trước của tài liệu đó và cho các bản xuất PDF và HTML của nó, trên đầu bất kỳ mẫu kiểu nào đang hoạt động — một cách để cung cấp cho một tài liệu một giao diện riêng mà không thay đổi cài đặt của bạn cho mọi thứ khác. Chỉ các bộ chọn thông thường: các quy tắc at như @media và @keyframes không được hỗ trợ và khối chỉ hoạt động trong các tài liệu Markdown.
Chuyển đổi & xuất
Menu Chuyển đổi sang trên thanh công cụ là nơi tài liệu đã hoàn thành rời khỏi Markzen. Nó thực hiện hai việc riêng biệt.
Chuyển đổi sang ngôn ngữ đánh dấu khác. Dưới Đánh dấu nhẹ, viết lại tài liệu đang mở dưới dạng bất kỳ ngôn ngữ đánh dấu nào trong số bảy ngôn ngữ đánh dấu khác — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText hoặc Textile. Hữu ích khi một wiki muốn MediaWiki, một diễn đàn muốn BBCode, một nhà xuất bản muốn AsciiDoc, hoặc bạn đang di chuyển ghi chú giữa các hệ sinh thái. Mỗi trong số tám ngôn ngữ xuất hiện một lần trong menu, dưới dạng ngôn ngữ đánh dấu: một tài liệu được lưu dưới dạng MediaWiki từ đây là cùng một tệp bạn sẽ nhận được ở bất kỳ nơi nào khác.
Xuất sang định dạng hoàn chỉnh. Chuyển tài liệu cho bộ chuyển đổi đi kèm, bộ chuyển đổi này xuất ra hơn hai mươi định dạng tài liệu, được nhóm theo mục đích sử dụng:
| Danh mục | Định dạng |
|---|---|
| Sách điện tử | EPUB 3, FictionBook2 |
| Trình xử lý văn bản | Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf) |
| Trình chiếu | Microsoft PowerPoint (.pptx), reveal.js (.html) |
| Dàn trang | InDesign ICML, LaTeX (.tex), Typst (.typ) |
| XML | DocBook, JATS, OpenDocument XML, TEI Simple |
| Sổ tay | Jupyter Notebook (.ipynb) |
| Dàn ý | OPML (.opml) |
Bộ chuyển đổi được tích hợp sẵn trong Markzen — không cần tải xuống hoặc cấu hình thêm. Bên cạnh đó, ba đầu ra nhanh nằm trên thanh công cụ: Lưu dưới dạng PDF và Lưu dưới dạng HTML xuất tài liệu đã kết xuất chính xác như đã xem trước (bao gồm mẫu kiểu, phông chữ và hình minh họa mở rộng), và In gửi nó đến máy in. Phông chữ mã di chuyển bên trong tệp đã xuất, vì vậy một khối mã hoặc sơ đồ ASCII sẽ hiển thị trên máy của người đọc giống như cách bạn đã thấy, cho dù họ có cài đặt phông chữ đó hay không.
Những gì được chuyển đi và những gì không. Một hình minh họa mở rộng kết xuất chỉ giữ nguyên là hình minh họa khi định dạng đích có thể chứa hình ảnh, vì vậy một tài liệu rời khỏi Markzen bằng một trong hai cách:
- Dưới dạng tài liệu bạn thấy — ba đầu ra trên thanh công cụ vừa mô tả (PDF, HTML, in) và năm trong số các định dạng trong bảng trên: EPUB 3, Microsoft Word (
.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) và Rich Text Format (.rtf). Sơ đồ, công thức và điểm số được viết dưới dạng hình ảnh và đến nguyên vẹn. - Dưới dạng văn bản nguồn của tài liệu — mọi mục tiêu khác và mọi chuyển đổi sang ngôn ngữ đánh dấu khác. Văn xuôi, tiêu đề, danh sách, bảng và liên kết đều được chuyển đổi; một khối
mermaidhoặckatexđến dưới dạng một khối mã thông thường chứa nguồn bạn đã nhập, vì các định dạng đó không có hình minh họa để Markzen chuyển cho chúng.
Vì vậy, một tài liệu được xây dựng xung quanh các sơ đồ tốt nhất nên được chuyển giao dưới dạng PDF, HTML, EPUB, Word, OpenDocument, PowerPoint hoặc RTF. LaTeX, Typst, reveal.js và phần còn lại vẫn cung cấp cho bạn toàn bộ tài liệu — với nguồn của mỗi hình minh họa được giữ nguyên, sẵn sàng cho các công cụ riêng của hệ sinh thái đó.
Xuất từ dòng lệnh
Markzen cũng hoạt động mà không cần mở cửa sổ. Truyền tệp thực thi Markzen một tệp nguồn và -o với đường dẫn đầu ra, và nó sẽ hiển thị tài liệu và ghi xuất thẳng ra đĩa:
markzen.exe report.md -o report.pdf
Nguồn có thể là bất kỳ định dạng đánh dấu nào trong số tám định dạng mà Markzen đọc; đầu ra là tệp PDF hoặc tệp HTML, được chọn bằng phần mở rộng của tên đầu ra. Quá trình xuất trải qua cùng một quá trình hiển thị như chính ứng dụng, vì vậy sơ đồ, công thức và mọi khối mở rộng khác đều xuất hiện dưới dạng hình ảnh trực tiếp. Các bản xuất sử dụng mẫu kiểu và phông chữ mặc định — dòng lệnh chạy trong hồ sơ sạch của riêng nó, tách biệt với ứng dụng, điều này cũng có nghĩa là nó hoạt động tốt trong khi Markzen đã mở.
Một số tài liệu có thể được xuất trong một lần gọi — cung cấp bất kỳ số cặp source -o output nào và một lần khởi chạy duy nhất sẽ hiển thị tất cả chúng, với chi phí chỉ bằng một phần nhỏ so với việc khởi chạy một lần cho mỗi tệp:
markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf
Phông chữ & giao diện
Markzen được xây dựng để làm cho tài liệu trông được sắp chữ thay vì chung chung. Các điều khiển cho việc đó nằm cùng nhau trên thanh công cụ phía sau nút Kiểu và phông chữ, để bạn có thể điều chỉnh chúng trong khi đọc; chủ đề và ngôn ngữ giao diện nằm trong Cài đặt → Hiển thị.
Mẫu kiểu
Kiểu cung cấp năm kiểu xem trước: Tiêu chuẩn, GitHub, Sách, Hiện đại, Tối giản. Mẫu bạn chọn cũng là kiểu được áp dụng cho các bản xuất PDF và HTML, vì vậy nó quyết định cách một tài liệu được chia sẻ đọc — chọn Sách hoặc Hiện đại cho thứ bạn sẽ giao, Tối giản để đọc không bị phân tâm. Mẫu chỉ tạo kiểu cho bản xem trước, không bao giờ cho trình chỉnh sửa.
Phông chữ
Ba bộ chọn trong cùng một bảng đặt một phông chữ riêng cho mỗi loại văn bản — Tiêu đề, Nội dung và Mã — đây là điều làm cho tài liệu Markzen có cảm giác được sắp chữ:
- Tiêu đề — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
- Nội dung — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
- Mã — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.
Các phông chữ mã được chọn vì một thuộc tính ngoài hình thức: tất cả chúng đều vẽ các ký tự vẽ hộp (│ ├ └ ─) mà các danh sách cây và sơ đồ ASCII được tạo thành, vì vậy một cây thư mục được dán vào một khối mã vẫn giữ nguyên hình dạng thay vì bị đứt đoạn. Chúng cũng là các biến thể không có chữ ghép — một phông chữ có chữ ghép vẽ lại != thành một ≠ duy nhất, điều này dễ chịu trong trình chỉnh sửa mã và sai trong một tài liệu có nghĩa là hiển thị những gì tệp thực sự nói. JetBrains Mono và Source Code Pro được tích hợp sẵn trong Markzen, vì vậy chúng hoạt động trên một máy chưa từng thấy chúng và không có bất kỳ kết nối nào.
Kích thước văn bản
Các nút Phóng to chữ và Thu nhỏ chữ trên thanh công cụ thay đổi kích thước văn bản.
Chủ đề & ngôn ngữ
Trong Cài đặt → Hiển thị:
- Giao diện — Sáng hoặc Tối. Mặc định: Sáng.
- Ngôn ngữ — Giao diện của Markzen được dịch sang hơn năm mươi ngôn ngữ, bao gồm các tập lệnh từ phải sang trái (tiếng Ả Rập, tiếng Do Thái) và CJK (tiếng Trung, tiếng Nhật, tiếng Hàn).
Khả năng tương thích
Các bảng tham chiếu: ngôn ngữ đánh dấu nào hỗ trợ gì, và mọi loại hình ảnh động mà Markzen có thể vẽ. Mọi thứ ở đây là về cái gì hoạt động ở đâu — các giải thích nằm trong các phần trên.
Ngôn ngữ đánh dấu nào có thể làm gì
| Ngôn ngữ đánh dấu | Mở tệp kết thúc bằng | Hình ảnh động | Bảng nội dung | Công thức trong câu | Không thể diễn đạt |
|---|---|---|---|---|---|
| Markdown | .md, .markdown |
tất cả | có | $…$ |
căn chỉnh văn bản |
| AsciiDoc | .adoc, .asciidoc, .asc |
tất cả trừ style |
có | chỉ khối | gạch ngang |
| reStructuredText | .rst, .rest |
tất cả trừ style |
có | $…$ |
gạch ngang |
| Org | .org |
tất cả trừ style |
có | $…$ |
căn chỉnh trái và phải |
| Textile | .textile |
tất cả trừ style |
có | chỉ khối | — |
| Djot | .dj |
tất cả trừ style |
có | $`…` |
— |
| MediaWiki | .wiki, .mediawiki, .wikitext |
tất cả trừ style |
có | <math> |
mã nội tuyến, gạch ngang, trích dẫn khối, căn chỉnh văn bản |
| BBCode | .bbcode, .bb |
tất cả trừ style |
có | chỉ khối | — |
Hình ảnh động — khối style là ngoại lệ duy nhất: nó áp dụng CSS cho chính tài liệu,
mà chỉ Markdown hỗ trợ. Mọi loại hình ảnh khác đều hoạt động trong mọi ngôn ngữ. Trong tài liệu BBCode
khối được viết [code=mermaid]…[/code] thay vì dấu gạch chéo; trong MediaWiki,
<syntaxhighlight lang="mermaid">…</syntaxhighlight>.
Không thể diễn đạt — đây là những giới hạn của chính ngôn ngữ đánh dấu, không phải của Markzen: nơi một ngôn ngữ không có ký hiệu cho một cái gì đó, Markzen không cung cấp nút cho nó thay vì viết một phương ngữ riêng tư mà chỉ nó có thể đọc lại. Xem Công thức bên trong một câu cho hàng toán học.
Mọi loại hình ảnh
Viết thẻ sau ba dấu gạch chéo mở — ```mermaid — và khối trở thành một hình ảnh.
| Danh mục | Hình ảnh | Thẻ khối | Ghi chú |
|---|---|---|---|
| Sơ đồ | Mermaid | mermaid |
sơ đồ luồng, trình tự, lớp, Gantt, ER, trạng thái |
| Graphviz | graphviz |
ngôn ngữ DOT | |
| Cytoscape | cytoscape |
biểu đồ mạng; xoay và phóng to trong bản xem trước | |
| Markmap | markmap |
bản đồ tư duy từ dàn ý gạch đầu dòng; nhấp để gập | |
| Timeline | timeline |
dòng thời gian sự kiện dọc | |
| Sơ đồ phần mềm | Nomnoml | nomnoml |
UML |
| PlantUML | plantuml |
UML — hình ảnh duy nhất cần kết nối internet | |
| DBML | dbml |
sơ đồ lược đồ cơ sở dữ liệu | |
| Biểu đồ | Chart.js | chartjs |
cột, đường, tròn, radar |
| Vega-Lite | vega-lite |
biểu đồ khai báo từ JSON | |
| ECharts | echarts |
biểu đồ tương tác lớn | |
| Phát triển CNTT | Pseudocode | pseudocode |
thuật toán được sắp chữ |
| Tabulator | tabulator |
bảng tương tác có thể sắp xếp | |
| Bytefield | bytefield |
bố cục trường bit và byte | |
| QR Code | qrcode |
||
| Railroad | railroad |
sơ đồ cú pháp | |
| WaveDrom | wavedrom |
sơ đồ thời gian kỹ thuật số | |
| Toán học | KaTeX | katex |
cũng $…$ trong một câu — xem bảng trên |
| AsciiMath | asciimath |
ký hiệu toán học văn bản thuần túy | |
| Đồ thị | function-plot | fnplot |
vẽ đường cong hàm |
| JSXGraph | jsxgraph |
hình học tương tác | |
| Plotly | plotly |
biểu đồ khoa học và 3-D | |
| Khoa học | SMILES | smiles |
sơ đồ cấu trúc hóa học |
| Âm nhạc | ABC Notation | abc |
bản nhạc từ văn bản thuần túy |
| VexFlow | vexflow |
khuông nhạc được khắc | |
| VexChords | vexchords |
sơ đồ hợp âm guitar | |
| ChordPro | chordpro |
hợp âm trên lời bài hát | |
| MusicXML | musicxml |
tổng phổ đầy đủ | |
| Trò chơi | Chess | chess |
một bàn cờ từ vị trí FEN |
| Go Board | goboard |
9×9, 13×13 và 19×19 | |
| Tài liệu | Markzen | markzen |
vô hình: đặt và định cỡ hình ảnh bên dưới nó, hoặc ghi đè bảng nội dung |
| Style | style |
vô hình: CSS cho tài liệu này — Chỉ Markdown |
Liên kết tệp
Trên Windows, trình cài đặt có thể đăng ký Markzen làm trình xử lý cho mọi loại tệp đánh dấu mà nó đọc — tất cả mười lăm tiện ích mở rộng được liệt kê trong Khả năng tương thích, trên cả tám ngôn ngữ. Sau khi đăng ký, nhấp đúp vào một trong các tệp đó trong Explorer sẽ mở trực tiếp trong Markzen, và nếu có nhiều trình chỉnh sửa được cài đặt, bạn vẫn có thể chọn Markzen thông qua "Mở bằng…".
Phím tắt
| Phím | Hành động |
|---|---|
Ctrl+S |
Lưu |
Ctrl+Shift+S |
Lưu thành |
Ctrl+ + / Ctrl+ - |
Tăng / giảm kích thước văn bản |
Các phím tắt trình soạn thảo tiêu chuẩn — tìm, thay thế, sao chép, dán, hoàn tác, làm lại — và các phím tắt thanh công cụ định dạng (in đậm Ctrl+B, in nghiêng Ctrl+I, tiêu đề Ctrl+H, liên kết Ctrl+K, và nhiều hơn nữa) hoạt động trong ngăn trình soạn thảo. Một phím tắt định dạng chỉ tồn tại khi đánh dấu hiện tại có cấu trúc — Ctrl+D không làm gì trong tài liệu AsciiDoc, không có gạch ngang riêng (xem Trình soạn thảo).
Mẹo
- Ẩn trình chỉnh sửa để đọc. Chế độ xem đơn với bản xem trước hiển thị biến Markzen thành một trình đọc sạch, và năm mẫu kiểu cho phép bạn đặt giao diện của nó.
- Một tài liệu, mọi loại nội dung. Một biểu đồ Mermaid, một phương trình KaTeX và một bản nhạc có thể nằm cạnh văn xuôi đơn giản — tất cả đều hiển thị cùng nhau và tất cả đều tồn tại khi xuất PDF và HTML.
- Mẫu kiểu là giao diện xuất. Bất kỳ mẫu nào bạn chọn là kiểu được tích hợp vào đầu ra PDF và HTML, vì vậy hãy đặt nó trước khi bạn xuất.
- Viết bằng ngôn ngữ đánh dấu bạn thích, cung cấp bằng định dạng họ cần. Soạn thảo bằng Markdown (hoặc bất kỳ ngôn ngữ nào trong số tám ngôn ngữ), sau đó sử dụng Chuyển đổi sang để có tệp Word, bản trình chiếu, sách điện tử hoặc nguồn LaTeX — không cần công cụ riêng biệt.