ความช่วยเหลือ

Markzen คืออะไร?

Markzen คือโปรแกรมแก้ไขเดสก์ท็อปสำหรับ ภาษา Markup แบบน้ำหนักเบา — Markdown และอีกหกภาษา — พร้อมการแสดงตัวอย่างแบบสดและจัดรูปแบบเต็มรูปแบบ คุณเขียนข้อความธรรมดาที่ทำเครื่องหมายด้วยเครื่องหมายวรรคตอนง่ายๆ ทางด้านซ้าย และ Markzen จะแสดงผลเป็น HTML ที่จัดรูปแบบทางด้านขวาขณะที่คุณพิมพ์

สิ่งที่ทำให้แตกต่างจากโปรแกรมแก้ไข Markdown ทั่วไปคือ การเดินทางไปกลับ Markzen อ่าน ภาษา Markup แปดภาษา, แสดงผล ส่วนขยายสด 30 รายการ (ไดอะแกรม, แผนภูมิ, สูตรคณิตศาสตร์, โน้ตเพลง, กระดานหมากรุก, รหัส QR) ภายในเอกสาร และ ส่งออก ไปยังรูปแบบมากกว่ายี่สิบรูปแบบ — หนังสืออิเล็กทรอนิกส์, Word, PowerPoint, LaTeX, Jupyter notebooks และอื่นๆ เขียนครั้งเดียว ส่งผลลัพธ์ออกไปได้เกือบทุกอย่าง ตัวแปลงถูกสร้างขึ้นมาในตัว จึงไม่จำเป็นต้องติดตั้งเครื่องมือภายนอก

คุณสามารถเปิดไฟล์ที่มีอยู่หรือเริ่มพิมพ์ได้เลย — ไม่จำเป็นต้องเปิดไฟล์ก่อน

ตัวแก้ไข

บานหน้าต่างด้านซ้ายคือตัวแก้ไขโค้ด CodeMirror เต็มรูปแบบ ไม่ใช่กล่องข้อความธรรมดา: มีการเน้นไวยากรณ์สำหรับมาร์กอัปที่คุณกำลังเขียน, แถบเครื่องมือจัดรูปแบบ (ตัวหนา, ตัวเอียง, หัวเรื่อง, รายการ และอื่นๆ, พร้อมปุ่มเฉพาะสำหรับการแทรกลิงก์และรูปภาพ — ดู ลิงก์และรูปภาพ — และสำหรับการแทรกตาราง, ดู ตารางและสเปรดชีต), และการค้นหาและแทนที่ ทางลัดการแก้ไขมาตรฐาน — คัดลอก, วาง, เลิกทำ, ทำซ้ำ — ทำงานได้ตามที่คุณคาดหวัง

คุณเขียนใน แปดภาษามาร์กอัปน้ำหนักเบา รูปแบบเหล่านี้เป็นรูปแบบข้อความธรรมดาที่แสดงโครงสร้างด้วยเครื่องหมายวรรคตอน (# สำหรับหัวเรื่อง, * สำหรับการเน้น) แทนที่จะเป็นสไตล์ที่ซ่อนอยู่ ดังนั้นเอกสารจึงยังคงอ่านได้ในรูปแบบข้อความและเป็นมิตรกับการเปรียบเทียบในระบบควบคุมเวอร์ชัน Markzen อ่านทั้งแปดภาษาและตัดสินใจว่าไฟล์เป็นภาษาใดจากนามสกุลของไฟล์ — คุณไม่เคยเลือกรูปแบบด้วยตนเอง ความเข้ากันได้ แสดงรายการนามสกุลที่เปิดภาษาใด

แต่ละภาษามีข้อตกลงของตัวเองและระบบนิเวศของเอกสารที่มีอยู่ของตัวเอง; Markzen แสดงผลแต่ละภาษาในภาษาถิ่นของตัวเองแทนที่จะแปลงทุกอย่างเป็น Markdown ก่อน BBCode เป็นภาษาที่ไม่มีมาตรฐานเดียว — ทุกฟอรัมประดิษฐ์รูปแบบของตัวเองขึ้นมา — ดังนั้น Markzen จึงอ่านอย่างใจกว้าง โดยยอมรับการสะกดคำทั่วไปควบคู่กันไป ([list] หรือ [ul], [h1] หรือ [heading=1]) และปล่อยให้แท็กใดๆ ที่ไม่รู้จักปรากฏให้เห็นเป็นข้อความธรรมดาแทนที่จะกลืนกินมัน หากต้องการเปลี่ยน ชนิด ของมาร์กอัปที่เอกสารเขียนขึ้น ให้ใช้เมนู แปลงเป็น ของแถบเครื่องมือ (ดู แปลงและส่งออก ด้านล่าง)

ไม่ใช่ทุกภาษาที่สามารถแสดงทุกสิ่งได้ แถบเครื่องมือจัดรูปแบบมีปุ่มเดียวกันในทุกเอกสาร แต่ Markzen จะเขียนมาร์กอัปที่ภาษากำหนดเท่านั้น — ไม่เคยประดิษฐ์ภาษาถิ่นส่วนตัวเพื่อปิดช่องว่าง ปุ่มที่ภาษาปัจจุบันไม่มีสัญกรณ์จะถูกปิดใช้งาน ตัวหนา, ตัวเอียง, หัวเรื่อง, รายการ, บล็อกโค้ด, ลิงก์, รูปภาพ, กฎ และตารางมีอยู่ในทั้งแปดภาษา; ช่องว่างเล็กน้อยแสดงอยู่ใน ความเข้ากันได้ Markdown เป็นภาษาที่ทำให้ผู้คนประหลาดใจ: ไม่มีวิธีมาตรฐานในการจัดกึ่งกลางย่อหน้า ดังนั้น Markzen จึงไม่มีปุ่มจัดแนวที่นั่นแทนที่จะเขียนสิ่งที่ผู้อ่านบางคนเท่านั้นที่จะยอมรับ

ขนาดข้อความถูกตั้งค่าด้วยปุ่ม ขยายตัวอักษร และ ย่อตัวอักษร ของแถบเครื่องมือ บานหน้าต่างตัวแก้ไขยังสามารถซ่อนได้ทั้งหมด — เมื่อซ่อนแล้ว Markzen จะกลายเป็นโปรแกรมอ่านล้วนๆ (ดู การแสดงตัวอย่างสด)

ลิงก์และรูปภาพ

แถบเครื่องมือจัดรูปแบบมีปุ่มเฉพาะสองปุ่มสำหรับใส่ลิงก์หรือรูปภาพลงในเอกสาร และแต่ละปุ่มจะเปิดป๊อปอัปขนาดเล็กตรงตำแหน่งที่เคอร์เซอร์ของคุณอยู่ ลิงก์ (Ctrl+K) — หรือกด Ctrl+K — แทรกไฮเปอร์ลิงก์: พิมพ์ข้อความลิงก์และที่อยู่ของมัน และ Markzen จะเขียนมาร์กอัปที่ถูกต้องสำหรับมัน รูปภาพ แทรกรูปภาพด้วยวิธีเดียวกัน โดยมีตัวเลือกเพิ่มเติมบางอย่างที่กล่าวถึงด้านล่าง

ทั้งสองถูกเขียนในมาร์กอัปที่เอกสารปัจจุบันใช้ — ลิงก์ที่แทรกในไฟล์ AsciiDoc จะออกมาเป็น AsciiDoc ในไฟล์ Org เป็น Org และอื่นๆ ในทุกแปดภาษา

เริ่มต้นจากที่อยู่ที่มีอยู่แล้ว วางที่อยู่เว็บลงในเอกสาร เลือก แล้วกด Ctrl+K: Markzen เห็นว่าสิ่งที่เลือกเป็นที่อยู่ไม่ใช่คำ จึงใส่ลงในช่องที่อยู่ของป๊อปอัปและปล่อยเคอร์เซอร์ไว้ในช่องข้อความว่าง รอว่าลิงก์ควรจะพูดว่าอะไร หากไม่มีสิ่งนั้น ที่อยู่ที่เลือกจะกลายเป็น ข้อความที่มองเห็นได้ ของลิงก์ — ลิงก์ที่อ่านเป็น URL เปล่า เส้นทางไฟล์แบบสัมบูรณ์ก็นับเป็นที่อยู่เช่นกัน ทั้งบน Windows และที่อื่น ๆ ดังนั้นทางลัดเดียวกันนี้จะเปลี่ยนเส้นทางที่วางเป็นลิงก์ไปยังไฟล์นั้น

การแก้ไขลิงก์หรือรูปภาพที่มีอยู่แล้ว วางเคอร์เซอร์ที่ใดก็ได้บนลิงก์หรือรูปภาพที่มีอยู่แล้วและเปิดป๊อปอัปอีกครั้ง (ปุ่ม หรือ Ctrl+K): Markzen จดจำโครงสร้าง โหลดข้อความและที่อยู่ปัจจุบันลงในป๊อปอัป และแทนที่ทั้งหมดเมื่อคุณยืนยัน — ดังนั้นคุณจึงแก้ไขมันในตำแหน่งแทนที่จะเผลอซ้อนลิงก์ใหม่ไว้ในลิงก์เก่า

สำหรับรูปภาพ ป๊อปอัปยังมีปุ่ม ค้นหารูปภาพ เพื่อเลือกไฟล์จากดิสก์แทนการพิมพ์เส้นทาง — มันจะเปิดในโฟลเดอร์ที่คุณนำรูปภาพมาล่าสุด ซึ่งแยกจากโฟลเดอร์ที่เอกสารของคุณมาจาก — และตัวเลือกที่สำคัญหนึ่งอย่าง: รูปภาพนั้นฝังอยู่หรือเชื่อมโยง

รูปภาพที่ฝังหรือเชื่อมโยง

เมื่อคุณแทรกรูปภาพ Markzen สามารถจัดเก็บไว้ในเอกสารได้สองวิธี:

• เชื่อมโยง — เอกสารเพียงแค่ ชี้ไปที่ รูปภาพ โดยใช้เส้นทางไฟล์หรือที่อยู่เว็บ ไฟล์เอกสารยังคงมีขนาดเล็ก แต่รูปภาพต้องเดินทางไปพร้อมกับมัน (หรือยังคงเข้าถึงได้ที่ URL) มิฉะนั้นจะไม่แสดงที่อื่น นี่คือค่าเริ่มต้น
• ฝังตัว — ไบต์จริงของรูปภาพถูกเขียน ลงใน เอกสารเป็นข้อความ (บล็อก data: แบบ base64) ดังนั้นไฟล์จึงเป็นแบบครบวงจร: ไฟล์เดียวมีทุกอย่าง โดยไม่มีอะไรต้องติดตาม การแลกเปลี่ยนคือขนาด — เอกสารจะเพิ่มขึ้นตามน้ำหนักของรูปภาพ และรูปภาพที่ฝังไม่สามารถใช้เส้นทางสัมพัทธ์ได้

เลือก Embedded เมื่อคุณต้องการไฟล์พกพาเดียวเพื่อส่งมอบ; เลือก Linked เมื่อคุณเก็บรูปภาพไว้ข้างเอกสารและต้องการให้ไฟล์มีขนาดเล็ก

สำหรับรูปภาพที่เชื่อมโยง ตัวเลือกเพิ่มเติมหนึ่งอย่างจะปรากฏขึ้น: พาธสัมพัทธ์ เมื่อรูปภาพอยู่ในโฟลเดอร์ของเอกสารเอง (หรือโฟลเดอร์ย่อย) การทำเครื่องหมายนี้จะเขียนการอ้างอิงเป็นเส้นทางสัมพัทธ์สั้น ๆ แทนที่จะเป็นเส้นทางสัมบูรณ์เต็มรูปแบบ ดังนั้นลิงก์จะยังคงทำงานเมื่อคุณย้ายเอกสารและรูปภาพพร้อมกัน มันจะเสนอให้เฉพาะเมื่อรูปภาพอยู่ในโฟลเดอร์ของเอกสาร — มิฉะนั้นจะไม่มีเส้นทางสัมพัทธ์ให้เขียน

รูปภาพที่ฝังยังคงเป็นระเบียบในตัวแก้ไข รูปภาพที่ฝังแบบ base64 เป็นข้อความยาว ๆ ที่จะฝังบรรทัดรอบ ๆ มัน ดังนั้น Markzen จึงพับแต่ละอันลงในชิปเล็ก ๆ ที่แสดงประเภทและขนาด (เช่น 🖼 webp · 38 KB) ชิปนี้เป็นแบบแสดงผลเท่านั้น — ข้อความพื้นฐานไม่ถูกแตะต้อง ดังนั้นการบันทึก คัดลอก หรือตัดจะนำรูปภาพเต็มไปด้วยเสมอ และเคอร์เซอร์จะข้ามชิปเป็นหน่วยเดียว

ไฟล์, แท็บ & การบันทึก

Markzen สามารถเปิดเอกสารได้หลายฉบับพร้อมกันตามที่คุณต้องการ โดยแต่ละฉบับจะอยู่ใน แท็บ ของตัวเอง เพื่อให้คุณสามารถทำงานกับไฟล์หลายไฟล์และสลับไปมาระหว่างกันได้อย่างอิสระ คุณไม่จำเป็นต้องเปิดไฟล์เพื่อเริ่มต้น — เพียงแค่เริ่มพิมพ์ในเอกสารเปล่าที่มีอยู่แล้ว หรือใช้ปุ่มไฟล์บนแถบเครื่องมือ:

• เอกสารใหม่ — เปิดเมนูสั้นๆ (สร้างใหม่) ที่แสดงรายการภาษา Markup ทั้งแปดภาษา; เลือกหนึ่งภาษาเพื่อเริ่มเอกสารใหม่ที่ว่างเปล่าซึ่งเขียนด้วย Markup นั้น ในแท็บใหม่
• เปิดไฟล์ Markdown — เรียกดูไฟล์ที่มีอยู่และเปิดไฟล์นั้น ตัวเลือกจะยอมรับรูปแบบ Markup ทั้งแปดรูปแบบ และ Markzen จะเลือกรูปแบบที่ถูกต้องจากนามสกุลไฟล์ มันจะเปิดในโฟลเดอร์ที่คุณนำเอกสารมาจากครั้งล่าสุด ซึ่งจะถูกจดจำไว้ระหว่างเซสชัน ดังนั้นคุณจึงไม่ต้องเริ่มต้นใหม่ทุกครั้ง
• บันทึก — เขียนเอกสารที่ใช้งานอยู่กลับไปยังไฟล์ของมัน เอกสารที่ไม่เคยบันทึกจะถูกเปลี่ยนไปที่ บันทึกเป็น เพื่อให้คุณสามารถตั้งชื่อได้ก่อน
• บันทึกเป็น — บันทึกเอกสารที่ใช้งานอยู่ไปยังไฟล์ใหม่ โดยปล่อยไฟล์ต้นฉบับไว้เหมือนเดิม

คุณยังสามารถ ลากไฟล์ออกจากตัวจัดการไฟล์ของคุณและวางลงบนหน้าต่าง เพื่อเปิดได้

เอกสารที่เปิดอยู่แต่ละฉบับจะเป็นแท็บที่ด้านบนของหน้าต่าง แท็บที่ยังไม่ได้บันทึกจะถูกทำเครื่องหมายด้วยจุด และแท็บที่ Markup ไม่ใช่ Markdown จะมีป้ายรูปแบบเล็กๆ (เช่น adoc) เครื่องหมาย × บนแท็บจะปิดแท็บนั้น — และการปิดเอกสารที่มีการเปลี่ยนแปลงที่ยังไม่ได้บันทึกจะไม่ทิ้งการเปลี่ยนแปลงเหล่านั้นไปอย่างเงียบๆ: แถบอินไลน์จะปรากฏบนแท็บเพื่อให้คุณสามารถ บันทึก หรือ ยกเลิก ก่อน

ในขณะที่เอกสารเปิดอยู่ Markzen จะเฝ้าดูไฟล์บนดิสก์ หากไฟล์มีการเปลี่ยนแปลงในโปรแกรมอื่นและคุณไม่มีการแก้ไขที่ยังไม่ได้บันทึกของคุณเอง Markzen จะดึงเวอร์ชันใหม่เข้ามาโดยอัตโนมัติ; หากคุณ มี การแก้ไขที่ยังไม่ได้บันทึก มันจะถามก่อน — แถบ โหลดใหม่ อินไลน์จะให้คุณตัดสินใจว่าจะใช้เวอร์ชันบนดิสก์หรือเก็บเวอร์ชันของคุณเอง

การแสดงตัวอย่างแบบสด

บานหน้าต่างด้านขวาคือเอกสารที่แสดงผลเป็น HTML ที่จัดรูปแบบแล้ว ซึ่งจะอัปเดตแบบสดขณะที่คุณพิมพ์ ลิงก์ใช้งานได้ ตารางจัดแนว โค้ดจะแสดงในบล็อกแบบ monospace รายการงานจะมีช่องทำเครื่องหมาย และบล็อกส่วนขยายการแสดงผลทุกบล็อก (ดูด้านล่าง) จะวาดรูปของมันในตำแหน่ง การแสดงตัวอย่างเป็นภาพที่ถูกต้องของสิ่งที่การส่งออก HTML หรือ PDF จะมีลักษณะเป็นอย่างไร

หากเอกสาร Markdown เปิดด้วย บล็อก YAML front-matter — ส่วน --- key: value --- ที่เครื่องมืออย่าง Jekyll, Hugo และ Obsidian วางไว้ที่ด้านบนสุด — Markzen จะแสดงผลเป็นบัตรข้อมูลเมตาที่เรียบร้อยเหนือเอกสาร แทนที่จะปล่อยให้ --- ปิดท้ายกลายเป็นหัวข้อที่หลงทาง

โหมดเค้าโครง

กลุ่มปุ่มแถบเครื่องมือสามปุ่มจะกำหนดสิ่งที่หน้าต่างแสดง:

• มุมมองแบบแบ่ง — ตัวแก้ไขและตัวอย่างเคียงข้างกัน ลากตัวแบ่งเพื่อเปลี่ยนปริมาณพื้นที่ที่แต่ละส่วนได้รับ
• แสดงตัวแก้ไข — ตัวแก้ไขเพียงอย่างเดียว เติมเต็มหน้าต่างสำหรับการเขียนที่ปราศจากสิ่งรบกวน
• แสดงตัวอย่าง — ตัวอย่างเพียงอย่างเดียว ผู้อ่านแบบเต็มความกว้างที่สะอาดตา

สารบัญ

ปุ่ม สารบัญ จะเปิดแผงที่สร้างขึ้นโดยอัตโนมัติจากทุกหัวข้อในเอกสาร (#, ##, ###, …) คลิกรายการใดก็ได้เพื่อเลื่อนตัวอย่างไปยังส่วนนั้น หัวข้อใดๆ ที่มีหัวข้อย่อยอยู่ใต้หัวข้อนั้นจะแสดงเครื่องหมายบั้ง: คลิกเพื่อ ยุบ ส่วนนั้นและซ่อนหัวข้อที่ซ้อนกัน หรือ ขยาย เพื่อนำกลับมา — เพื่อให้คุณสามารถพับโครงร่างยาวๆ ลงมาเหลือเพียงส่วนที่คุณกำลังทำงานอยู่ ปุ่มเล็กๆ 2 / 3 / 4 ในส่วนหัวของแผงจะจำกัดโครงร่างให้มีความลึกของหัวข้อนั้น — มีประโยชน์ในเอกสารยาวๆ เมื่อคุณต้องการเพียงระดับบนสุดที่มองเห็นได้ — และการคลิกปุ่มที่ใช้งานอยู่อีกครั้งจะนำทุกระดับกลับมา แผงจะปรับขนาดโดยการลากขอบด้านซ้ายและยุบลงเพื่อเพิ่มพื้นที่อ่าน เป็นเครื่องช่วยนำทางภายในแอปเท่านั้น — จะไม่ปรากฏในการส่งออก

การจัดเตรียมโครงร่างของคุณเอง หากหัวข้อไม่ใช่โครงร่างที่คุณต้องการ เอกสารสามารถมีโครงร่างของตัวเองได้ บล็อกที่ถูกล้อมรอบด้วยแท็ก markzen ซึ่งบรรทัดแรกคือ toc จะแทนที่แผงที่สร้างขึ้นด้วยรายการที่เขียนอยู่ใต้บล็อกนั้น:

`markdown

```markzen
toc
- [Introduction](#intro)
  - [Background](#background)
- [Results](#results)
```

การเยื้องจะกำหนดระดับ และแต่ละรายการจะชี้ไปยังจุดยึดที่ต้องมีอยู่ในเอกสารเอง — หัวข้อที่คุณให้ id ที่ชัดเจน หรือ <a id="intro"></a> ธรรมดา บล็อกนั้นไม่ได้วาดอะไรเลย: เป็นข้อมูลเมตาที่แผงอ่าน

ตารางและสเปรดชีต

ตารางสามารถย้ายไปมาระหว่าง Markzen และสเปรดชีตใดๆ ได้อย่างราบรื่น วาง ข้อความที่คั่นด้วยแท็บ — ที่คัดลอกมาจาก Excel, Google Sheets, Word หรือตารางบนเว็บ — ลงในตัวแก้ไข แล้ว Markzen จะเปลี่ยนให้เป็นตารางที่เหมาะสมซึ่งเขียนด้วยมาร์กอัปของเอกสารเอง แทนที่จะวางอักขระแท็บเป็นกำแพง ตัวอ่านการวางจะรับรู้เครื่องหมายคำพูด (จัดการเซลล์ที่มีแท็บ ตัวแบ่งบรรทัด หรือเครื่องหมายคำพูดได้อย่างถูกต้อง) และจะทำงานเมื่อคลิปบอร์ดมีตารางสี่เหลี่ยมที่สะอาดอย่างน้อยสองคอลัมน์เท่านั้น ส่วนอื่นๆ จะวางเป็นข้อความธรรมดา

คุณยังสามารถสร้างตารางใหม่ตั้งแต่ต้นได้ ปุ่ม แทรกตาราง บนแถบเครื่องมือจะเปิดตารางขนาดเล็ก — กวาดผ่านเพื่อเลือกจำนวนแถวและคอลัมน์ที่คุณต้องการ แล้ว Markzen จะเขียนตารางเปล่าขนาดนั้นด้วยมาร์กอัปของเอกสารเอง พร้อมให้คุณพิมพ์ลงไป แถวแรกคือแถวส่วนหัว

การย้อนกลับก็ใช้ได้เช่นกัน เลื่อนเมาส์ไปเหนือตารางที่แสดงผลในหน้าต่างแสดงตัวอย่าง แล้วปุ่มคัดลอกจะปรากฏขึ้นที่มุม: มันจะคัดลอกตารางกลับออกมาเป็นข้อความที่คั่นด้วยแท็บ ซึ่งสามารถวางลงในเซลล์สเปรดชีตหรือเอกสาร Word ได้โดยตรง ปุ่มคัดลอกเหล่านี้เป็นเพียงความสะดวกในการแสดงตัวอย่างเท่านั้น — จะถูกลบออกจากการส่งออกและการแปลงทุกครั้ง ดังนั้นไฟล์ที่แชร์จะมีเพียงตารางที่สะอาดเท่านั้น

ส่วนขยายการเรนเดอร์

Markzen ขยายมาร์กอัปมาตรฐานผ่านบล็อกโค้ดแบบมีรั้ว แท็กภาษาที่อยู่หลังเครื่องหมายแบ็กติกสามตัวที่เปิดอยู่จะกำหนดวิธีการเรนเดอร์บล็อก: แท็กที่ Markzen รู้จักว่าเป็นส่วนขยายจะวาดรูปภาพสดแทนที่จะแสดงโค้ด

รูปภาพแต่ละชนิดจะถูกวาดโดยเอ็นจิ้นการเรนเดอร์ของตัวเอง และ Markzen จะดึงเอ็นจิ้นเมื่อเอกสารร้องขอเป็นครั้งแรก แทนที่จะโหลดทั้งหมดเมื่อเริ่มต้น ซึ่งเป็นเหตุผลว่าทำไมแอปจึงเริ่มต้นได้เกือบจะทันที และทำไมไดอะแกรม แรก ของชนิดที่กำหนดอาจใช้เวลาสักครู่ในการปรากฏ ในขณะที่ไดอะแกรมถัดไปจะปรากฏทันที

ตัวอย่างเช่น แหล่งที่มานี้:

```mermaid
graph LR
  A --> B --> C
```

จะเรนเดอร์เป็นผังงานสด ไม่ใช่รายการโค้ด — และยังคงเป็นผังงานในการส่งออก PDF และ HTML ด้วย

ไดอะแกรม แผนภูมิ คณิตศาสตร์ สัญกรณ์ดนตรี กระดานหมากรุกและโกะ รหัส QR และอื่นๆ อีกมากมายถูกสร้างขึ้นในตัว — ความเข้ากันได้ จะแสดงรายการทั้งหมดพร้อมแท็ก

ส่วนขยายแต่ละรายการมีแท็กภาษาของตัวเอง (mermaid, chartjs, katex, abc, chess, …) คุณสามารถผสมผสานได้มากเท่าที่คุณต้องการกับข้อความธรรมดาในเอกสารเดียว — ทั้งหมดจะเรนเดอร์พร้อมกัน ไม่ว่ารูปภาพจะยังคงเป็นรูปภาพเมื่อเอกสารออกจาก Markzen หรือไม่นั้นขึ้นอยู่กับว่าคุณส่งไปที่ใด — ดู แปลงและส่งออก ด้านล่าง

สูตรภายในประโยค

สูตรทางคณิตศาสตร์สามารถเป็น บล็อก ของตัวเองได้ — บล็อก katex หรือ asciimath ที่อยู่โดดเดี่ยวและจัดกึ่งกลางเหมือนสมการในตำราเรียน ซึ่งใช้ได้กับภาษามาร์กอัปทั้งแปดภาษา

สูตรยังสามารถอยู่ ภายในประโยค ได้ด้วย เพื่อให้ "พื้นที่คือ pi r กำลังสอง" อ่านเป็นข้อความบรรทัดเดียวพร้อมสัญลักษณ์จริงอยู่ในนั้น ซึ่งขึ้นอยู่กับภาษามาร์กอัปที่มีสัญกรณ์สำหรับมัน และแต่ละภาษาก็สะกดต่างกัน — สัญกรณ์ต่อภาษาอยู่ใน ความเข้ากันได้

Textile และ BBCode เป็นสองข้อยกเว้น และเป็นข้อจำกัดของภาษาเหล่านั้นมากกว่าของ Markzen: ไม่มีภาษาใดที่กำหนดวิธีการเขียนคณิตศาสตร์ ในเอกสาร Textile หรือ BBCode สูตรจึงต้องเป็นบล็อกของตัวเอง ไม่มีอะไรสูญหาย — สูตรจะเรนเดอร์ และจะรอดจากการส่งออก — เพียงแค่ไม่สามารถถักทอเป็นข้อความบรรทัดเดียวได้

การวางตำแหน่งและปรับขนาดรูปภาพ

เลื่อนเมาส์ไปที่รูปภาพที่เรนเดอร์แล้วในการแสดงตัวอย่าง แผงเล็กๆ จะปรากฏขึ้นข้างๆ: ปุ่ม จัดแนว (ซ้าย, กลาง, ขวา) และ — สำหรับรูปภาพที่สามารถปรับขนาดได้ — กล่อง ความกว้าง และ ความสูง เป็นพิกเซล remove style block จะล้างค่าเหล่านั้นอีกครั้ง

การเลือกนั้นไม่ได้ถูกเก็บไว้ที่ใดที่หนึ่งที่มองไม่เห็น: แผงจะเขียนลงในเอกสาร เป็นบล็อกสั้นๆ ที่มีแท็ก markzen ซึ่งวางอยู่หน้าภาพที่ใช้โดยตรง

```markzen
style
align center
width 480
```

ดังนั้นเค้าโครงจะเดินทางไปพร้อมกับไฟล์ — เป็นส่วนหนึ่งของสิ่งที่คุณบันทึก ส่งมอบ และส่งออก บนเครื่องใดก็ได้ คุณสามารถเขียนบล็อกด้วยมือได้เช่นกัน: คำสั่งหนึ่งบรรทัดต่อบรรทัด align (left, center หรือ right), width และ height เป็นพิกเซล ซึ่งใช้กับบล็อกที่อยู่ด้านล่างโดยตรงเสมอ

การจัดรูปแบบเอกสารเดียวด้วย CSS

เอกสาร Markdown ยังสามารถมีสไตล์ชีตของตัวเองได้ ในบล็อกแบบมีรั้วที่มีแท็ก style:

```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```

กฎเหล่านี้ใช้กับการแสดงตัวอย่างเอกสารนั้นและการส่งออก PDF และ HTML นอกเหนือจากเทมเพลตสไตล์ที่ใช้งานอยู่ — เป็นวิธีที่จะทำให้เอกสารหนึ่งมีรูปลักษณ์ของตัวเองโดยไม่ต้องเปลี่ยนการตั้งค่าสำหรับสิ่งอื่นทั้งหมด ตัวเลือกทั่วไปเท่านั้น: กฎ @ เช่น @media และ @keyframes ไม่รองรับ และบล็อกนี้ใช้ได้เฉพาะในเอกสาร Markdown เท่านั้น

แปลงและส่งออก

เมนู แปลงเป็น บนแถบเครื่องมือคือจุดที่เอกสารที่เสร็จสมบูรณ์จะออกจาก Markzen ซึ่งทำหน้าที่สองอย่างที่แตกต่างกัน

แปลงเป็นภาษา Markup อื่นๆ ภายใต้ มาร์กอัปน้ำหนักเบา ให้เขียนเอกสารที่เปิดอยู่ใหม่เป็น Markup อื่นๆ อีกเจ็ดรูปแบบ ได้แก่ AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText หรือ Textile มีประโยชน์เมื่อ wiki ต้องการ MediaWiki, ฟอรัมต้องการ BBCode, ผู้จัดพิมพ์ต้องการ AsciiDoc หรือคุณกำลังย้ายบันทึกระหว่างระบบนิเวศ แต่ละรูปแบบทั้งแปดจะปรากฏในเมนูหนึ่งครั้งในฐานะภาษา Markup: เอกสารที่บันทึกเป็น MediaWiki จากที่นี่จะเป็นไฟล์เดียวกับที่คุณจะได้รับจากที่อื่น

ส่งออกเป็นรูปแบบที่เสร็จสมบูรณ์ ส่งเอกสารไปยังตัวแปลงที่มาพร้อมกับโปรแกรม ซึ่งจะสร้างรูปแบบเอกสารมากกว่ายี่สิบรูปแบบ โดยจัดกลุ่มตามวัตถุประสงค์:

หมวดหมู่	รูปแบบ
อีบุ๊ก	EPUB 3, FictionBook2
โปรแกรมประมวลผลคำ	Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf)
งานนำเสนอ	Microsoft PowerPoint (.pptx), reveal.js (.html)
การเรียงพิมพ์	InDesign ICML, LaTeX (.tex), Typst (.typ)
XML	DocBook, JATS, OpenDocument XML, TEI Simple
สมุดบันทึก	Jupyter Notebook (.ipynb)
โครงร่าง	OPML (.opml)

ตัวแปลงมาพร้อมกับ Markzen — ไม่ต้องดาวน์โหลดหรือกำหนดค่าเพิ่มเติม นอกจากนี้ ยังมีเอาต์พุตด่วนสามรายการบนแถบเครื่องมือ: บันทึกเป็น PDF และ บันทึกเป็น HTML ส่งออกเอกสารที่แสดงผลตามที่แสดงตัวอย่าง (รวมถึงเทมเพลตสไตล์, ฟอนต์ และรูปภาพส่วนขยาย) และ พิมพ์ ส่งไปยังเครื่องพิมพ์ ฟอนต์โค้ดจะเดินทาง ภายใน ไฟล์ที่ส่งออก ดังนั้นบล็อกโค้ดหรือไดอะแกรม ASCII จะปรากฏบนเครื่องของผู้อ่านในลักษณะที่คุณเห็น ไม่ว่าพวกเขาจะติดตั้งฟอนต์นั้นหรือไม่ก็ตาม

สิ่งที่เดินทางและสิ่งที่ไม่เดินทาง รูปภาพส่วนขยายการเรนเดอร์จะยังคงเป็นรูปภาพเฉพาะเมื่อรูปแบบเป้าหมายสามารถเก็บรูปภาพได้ ดังนั้นเอกสารจะออกจาก Markzen โดยหนึ่งในสองเส้นทาง:

• เป็นเอกสารที่คุณเห็น — เอาต์พุตแถบเครื่องมือสามรายการที่อธิบายไว้ข้างต้น (PDF, HTML, พิมพ์) และห้ารูปแบบในตารางด้านบน: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) และ Rich Text Format (.rtf) ไดอะแกรม สูตร และคะแนนจะถูกเขียนออกมาเป็นรูปภาพและมาถึงอย่างสมบูรณ์
• เป็นข้อความต้นฉบับของเอกสาร — เป้าหมายอื่นๆ ทั้งหมด และการแปลงเป็นภาษา Markup อื่นๆ ทั้งหมด ข้อความธรรมดา หัวเรื่อง รายการ ตาราง และลิงก์ทั้งหมดจะถูกแปลง; บล็อก mermaid หรือ katex จะมาถึงเป็นบล็อกโค้ดธรรมดาที่เก็บแหล่งที่มาที่คุณพิมพ์ เนื่องจากรูปแบบเหล่านั้นไม่มีรูปภาพให้ Markzen ส่งให้

ดังนั้นเอกสารที่สร้างขึ้นจากไดอะแกรมจึงเหมาะที่สุดที่จะส่งมอบเป็น PDF, HTML, EPUB, Word, OpenDocument, PowerPoint หรือ RTF LaTeX, Typst, reveal.js และส่วนที่เหลือยังคงให้เอกสารทั้งหมดแก่คุณ — โดยมีแหล่งที่มาของรูปภาพแต่ละรูปอยู่ในตำแหน่งเดิม พร้อมสำหรับเครื่องมือของระบบนิเวศนั้นๆ

การส่งออกผ่านบรรทัดคำสั่ง

Markzen ยังสามารถทำงานได้โดยไม่ต้องเปิดหน้าต่าง ส่งไฟล์ต้นฉบับและ -o พร้อมเส้นทางเอาต์พุตไปยังไฟล์ปฏิบัติการของ Markzen แล้วมันจะเรนเดอร์เอกสารและเขียนไฟล์ที่ส่งออกลงดิสก์โดยตรง:

markzen.exe report.md -o report.pdf

ไฟล์ต้นฉบับสามารถเป็นรูปแบบมาร์กอัปใดก็ได้จากแปดรูปแบบที่ Markzen อ่านได้; ไฟล์เอาต์พุตจะเป็นไฟล์ PDF หรือ HTML ซึ่งเลือกได้จากนามสกุลของชื่อไฟล์เอาต์พุต การส่งออกจะผ่านการเรนเดอร์แบบเดียวกับที่แอปใช้ ดังนั้นไดอะแกรม สูตร และบล็อกส่วนขยายอื่นๆ ทั้งหมดจะออกมาเป็นรูปภาพจริง การส่งออกจะใช้เทมเพลตสไตล์และฟอนต์เริ่มต้น — บรรทัดคำสั่งจะทำงานในโปรไฟล์ที่สะอาดของตัวเอง แยกจากแอป ซึ่งหมายความว่ามันทำงานได้ดีในขณะที่ Markzen เปิดอยู่แล้ว

สามารถส่งออกเอกสารหลายฉบับได้ในการเรียกครั้งเดียว — ระบุคู่ source -o output ได้ไม่จำกัดจำนวน และการเปิดใช้งานครั้งเดียวจะเรนเดอร์ทั้งหมด โดยมีค่าใช้จ่ายเพียงเล็กน้อยเมื่อเทียบกับการเปิดใช้งานครั้งละหนึ่งไฟล์:

markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf

แบบอักษรและลักษณะที่ปรากฏ

Markzen สร้างขึ้นเพื่อให้เอกสารดูเหมือนจัดพิมพ์มากกว่าเป็นแบบทั่วไป การควบคุมสำหรับสิ่งนั้นจะอยู่รวมกันบน แถบเครื่องมือ หลังปุ่ม สไตล์และแบบอักษร เพื่อให้คุณสามารถปรับเปลี่ยนได้ในขณะที่คุณอ่าน ธีมและภาษาของอินเทอร์เฟซจะอยู่ใน Settings → แสดงผล

เทมเพลตสไตล์

สไตล์ มีห้าสไตล์ตัวอย่าง: Standard, GitHub, Book, Modern, Minimal เทมเพลตที่คุณเลือกยังเป็นสไตล์ที่ใช้กับไฟล์ PDF และ HTML ที่ส่งออก ดังนั้นจึงเป็นตัวกำหนดว่าเอกสารที่แชร์จะอ่านอย่างไร — เลือก Book หรือ Modern สำหรับเอกสารที่คุณจะส่งมอบ Minimal สำหรับการอ่านที่ปราศจากสิ่งรบกวน เทมเพลตจะจัดรูปแบบเฉพาะการแสดงตัวอย่างเท่านั้น ไม่ใช่ตัวแก้ไข

แบบอักษร

ตัวเลือกสามตัวในแผงเดียวกันจะตั้งค่าแบบอักษรแยกกันสำหรับข้อความแต่ละประเภท — หัวเรื่อง, เนื้อหา และ โค้ด — ซึ่งเป็นสิ่งที่ทำให้เอกสาร Markzen รู้สึกเหมือนจัดพิมพ์:

• Heading — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
• Body — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
• Code — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

แบบอักษรโค้ดถูกเลือกสำหรับคุณสมบัติหนึ่งที่นอกเหนือจากรูปลักษณ์: ทั้งหมดจะวาด อักขระวาดกล่อง (│ ├ └ ─) ที่ใช้สร้างรายการต้นไม้และไดอะแกรม ASCII ดังนั้นโครงสร้างไดเรกทอรีที่วางลงในบล็อกโค้ดจะรักษารูปร่างไว้แทนที่จะแตกเป็นช่องว่าง นอกจากนี้ยังเป็นแบบอักษรที่ไม่มีการเชื่อมโยง — แบบอักษรที่มีการเชื่อมโยงจะวาด != ใหม่เป็น ≠ ตัวเดียว ซึ่งน่าพอใจในตัวแก้ไขโค้ดและผิดในเอกสารที่ตั้งใจจะแสดงสิ่งที่ไฟล์ระบุจริง JetBrains Mono และ Source Code Pro มาพร้อมกับ Markzen ดังนั้นจึงใช้งานได้บนเครื่องที่ไม่เคยเห็นมาก่อนและไม่มีการเชื่อมต่อใดๆ เลย

ขนาดข้อความ

ปุ่ม ขยายตัวอักษร และ ย่อตัวอักษร บนแถบเครื่องมือจะเปลี่ยนขนาดข้อความ

ธีมและภาษา

ใน Settings → แสดงผล:

• ธีม — สว่าง หรือ มืด ค่าเริ่มต้น: Light
• ภาษา — อินเทอร์เฟซของ Markzen ได้รับการแปลเป็นภาษามากกว่าห้าสิบภาษา รวมถึงสคริปต์จากขวาไปซ้าย (อาหรับ, ฮีบรู) และ CJK (จีน, ญี่ปุ่น, เกาหลี)

ความเข้ากันได้

ตารางอ้างอิง: สิ่งที่ภาษามาร์กอัปแต่ละภาษารองรับ และรูปภาพสดทุกประเภทที่ Markzen สามารถวาดได้ ทุกสิ่งในที่นี้เกี่ยวกับ สิ่งที่ทำงานได้ที่ไหน — คำอธิบายอยู่ในส่วนด้านบน

สิ่งที่ภาษามาร์กอัปแต่ละภาษาทำได้

ภาษามาร์กอัป	เปิดไฟล์ที่ลงท้ายด้วย	รูปภาพสด	แผงเนื้อหา	สูตรในประโยค	ไม่สามารถแสดงออกได้
Markdown	.md, .markdown	ทั้งหมด	ใช่	$…$	การจัดตำแหน่งข้อความ
AsciiDoc	.adoc, .asciidoc, .asc	ทั้งหมด ยกเว้น style	ใช่	บล็อกเท่านั้น	ขีดฆ่า
reStructuredText	.rst, .rest	ทั้งหมด ยกเว้น style	ใช่	$…$	ขีดฆ่า
Org	.org	ทั้งหมด ยกเว้น style	ใช่	$…$	การจัดตำแหน่งซ้ายและขวา
Textile	.textile	ทั้งหมด ยกเว้น style	ใช่	บล็อกเท่านั้น	—
Djot	.dj	ทั้งหมด ยกเว้น style	ใช่	$`…`	—
MediaWiki	.wiki, .mediawiki, .wikitext	ทั้งหมด ยกเว้น style	ใช่	<math>	โค้ดอินไลน์, ขีดฆ่า, blockquote, การจัดตำแหน่งข้อความ
BBCode	.bbcode, .bb	ทั้งหมด ยกเว้น style	ใช่	บล็อกเท่านั้น	—

รูปภาพสด — บล็อก style เป็นข้อยกเว้นเดียว: มันใช้ CSS กับเอกสารเอง ซึ่ง Markdown เท่านั้นที่รองรับ รูปภาพประเภทอื่น ๆ ทั้งหมดทำงานได้ในทุกภาษา ในเอกสาร BBCode บล็อกจะเขียนเป็น [code=mermaid]…[/code] แทนที่จะใช้ backticks; ใน MediaWiki, <syntaxhighlight lang="mermaid">…</syntaxhighlight>

ไม่สามารถแสดงออกได้ — นี่คือข้อจำกัดของภาษามาร์กอัปเอง ไม่ใช่ของ Markzen: หากภาษาไม่มีสัญลักษณ์สำหรับบางสิ่ง Markzen จะไม่มีปุ่มสำหรับสิ่งนั้น แทนที่จะเขียนภาษาถิ่นส่วนตัวที่อ่านได้เฉพาะตัวมันเองเท่านั้น ดู สูตรภายในประโยค สำหรับแถวคณิตศาสตร์

รูปภาพทุกประเภท

เขียนแท็กหลังเครื่องหมาย backticks สามตัวเปิด — ```mermaid — และบล็อกจะกลายเป็นรูปภาพ

หมวดหมู่	รูปภาพ	แท็กบล็อก	หมายเหตุ
ไดอะแกรม	Mermaid	mermaid	ผังงาน, ลำดับ, คลาส, Gantt, ER, สถานะ
	Graphviz	graphviz	ภาษา DOT
	Cytoscape	cytoscape	กราฟเครือข่าย; แพนและซูมในหน้าตัวอย่าง
	Markmap	markmap	แผนที่ความคิดจากโครงร่างแบบจุด; คลิกเพื่อพับ
	Timeline	timeline	ไทม์ไลน์เหตุการณ์แนวตั้ง
ไดอะแกรมซอฟต์แวร์	Nomnoml	nomnoml	UML
	PlantUML	plantuml	UML — รูปภาพเดียวที่ต้องการการเชื่อมต่ออินเทอร์เน็ต
	DBML	dbml	ไดอะแกรมโครงสร้างฐานข้อมูล
แผนภูมิ	Chart.js	chartjs	แท่ง, เส้น, วงกลม, เรดาร์
	Vega-Lite	vega-lite	แผนภูมิเชิงประกาศจาก JSON
	ECharts	echarts	แผนภูมิเชิงโต้ตอบขนาดใหญ่
การพัฒนา IT	Pseudocode	pseudocode	อัลกอริทึมที่จัดเรียง
	Tabulator	tabulator	ตารางเชิงโต้ตอบที่จัดเรียงได้
	Bytefield	bytefield	เค้าโครงฟิลด์บิตและไบต์
	QR Code	qrcode
	Railroad	railroad	ไดอะแกรมไวยากรณ์
	WaveDrom	wavedrom	ไดอะแกรมเวลาดิจิทัล
คณิตศาสตร์	KaTeX	katex	และ $…$ ในประโยค — ดูตารางด้านบน
	AsciiMath	asciimath	สัญกรณ์คณิตศาสตร์แบบข้อความธรรมดา
กราฟ	function-plot	fnplot	พล็อตเส้นโค้งฟังก์ชัน
	JSXGraph	jsxgraph	เรขาคณิตเชิงโต้ตอบ
	Plotly	plotly	แผนภูมิวิทยาศาสตร์และ 3 มิติ
วิทยาศาสตร์	SMILES	smiles	ไดอะแกรมโครงสร้างทางเคมี
ดนตรี	ABC Notation	abc	โน้ตเพลงจากข้อความธรรมดา
	VexFlow	vexflow	บรรทัดห้าเส้นที่แกะสลัก
	VexChords	vexchords	ไดอะแกรมคอร์ดกีตาร์
	ChordPro	chordpro	คอร์ดเหนือเนื้อเพลง
	MusicXML	musicxml	โน้ตเพลงเต็ม
เกม	Chess	chess	กระดานจากตำแหน่ง FEN
	Go Board	goboard	9×9, 13×13 และ 19×19
เอกสาร	Markzen	markzen	มองไม่เห็น: วางและปรับขนาดรูปภาพด้านล่าง หรือแทนที่แผงเนื้อหา
	Style	style	มองไม่เห็น: CSS สำหรับเอกสารนี้ — Markdown เท่านั้น

การเชื่อมโยงไฟล์

บน Windows ตัวติดตั้งสามารถลงทะเบียน Markzen เป็นตัวจัดการสำหรับไฟล์มาร์กอัป ทุกประเภท ที่อ่านได้ ซึ่งรวมถึงส่วนขยายทั้งสิบห้าที่ระบุไว้ใน ความเข้ากันได้ ในทั้งแปดภาษา เมื่อลงทะเบียนแล้ว การดับเบิลคลิกที่ไฟล์เหล่านั้นใน Explorer จะเปิดไฟล์นั้นใน Markzen ทันที และหากมีการติดตั้งโปรแกรมแก้ไขหลายตัว คุณยังคงสามารถเลือก Markzen ผ่าน "เปิดด้วย..." ได้

ทางลัดคีย์บอร์ด

คีย์	การกระทำ
Ctrl+S	บันทึก
Ctrl+Shift+S	บันทึกเป็น
Ctrl+ + / Ctrl+ -	เพิ่ม / ลดขนาดข้อความ

ทางลัดของโปรแกรมแก้ไขมาตรฐาน — ค้นหา, แทนที่, คัดลอก, วาง, เลิกทำ, ทำซ้ำ — และทางลัดของแถบเครื่องมือจัดรูปแบบ (ตัวหนา Ctrl+B, ตัวเอียง Ctrl+I, หัวเรื่อง Ctrl+H, ลิงก์ Ctrl+K และอื่นๆ) ทำงานในบานหน้าต่างโปรแกรมแก้ไข ทางลัดการจัดรูปแบบจะใช้ได้เฉพาะเมื่อมาร์กอัปปัจจุบันมีโครงสร้างนั้น — Ctrl+D จะไม่มีผลในเอกสาร AsciiDoc ซึ่งไม่มีการขีดทับของตัวเอง (ดู โปรแกรมแก้ไข)

เคล็ดลับ

• ซ่อนตัวแก้ไขเพื่ออ่าน มุมมองเดียวที่แสดงตัวอย่างจะเปลี่ยน Markzen ให้เป็นโปรแกรมอ่านที่สะอาดตา และเทมเพลตสไตล์ทั้งห้าแบบช่วยให้คุณตั้งค่าลักษณะที่ปรากฏได้
• เอกสารเดียว เนื้อหาทุกประเภท ผังงาน Mermaid, สมการ KaTeX และโน้ตเพลงสามารถอยู่ข้างข้อความธรรมดาได้ — ทั้งหมดจะแสดงผลพร้อมกันและทั้งหมดจะรอดจากการส่งออกเป็น PDF และ HTML
• เทมเพลตสไตล์คือลักษณะการส่งออก เทมเพลตใดก็ตามที่คุณเลือกคือสไตล์ที่ฝังอยู่ในเอาต์พุต PDF และ HTML ดังนั้นให้ตั้งค่าก่อนที่คุณจะส่งออก
• เขียนในมาร์กอัปที่คุณชอบ ส่งมอบในรูปแบบที่พวกเขาต้องการ ร่างใน Markdown (หรือหนึ่งในแปดรูปแบบ) จากนั้นใช้ Convert to สำหรับไฟล์ Word, สไลด์, ebook หรือแหล่งที่มา LaTeX — ไม่ต้องใช้เครื่องมือแยกต่างหาก