Βοήθεια

Τι είναι το Markzen;

Το Markzen είναι ένα πρόγραμμα επεξεργασίας επιφάνειας εργασίας για γλώσσες ελαφριάς σήμανσης — Markdown και έξι άλλες — με ζωντανή, πλήρως διαμορφωμένη προεπισκόπηση. Γράφετε απλό κείμενο με απλή στίξη στα αριστερά, και το Markzen το αποδίδει ως μορφοποιημένο HTML στα δεξιά καθώς πληκτρολογείτε.

Αυτό που το ξεχωρίζει από ένα συνηθισμένο πρόγραμμα επεξεργασίας Markdown είναι η αμφίδρομη μετατροπή. Το Markzen διαβάζει οκτώ γλώσσες σήμανσης, αποδίδει 30 ζωντανές επεκτάσεις (διαγράμματα, γραφήματα, μαθηματικούς τύπους, παρτιτούρες, σκακιέρες, κωδικούς QR) μέσα στο έγγραφο, και εξάγει σε περισσότερες από είκοσι μορφές — ηλεκτρονικά βιβλία, Word, PowerPoint, LaTeX, σημειωματάρια Jupyter και άλλα. Γράψτε μία φορά, παραδώστε το αποτέλεσμα σχεδόν σε οτιδήποτε. Ο μετατροπέας είναι ενσωματωμένος, οπότε δεν χρειάζεται να εγκαταστήσετε εξωτερικά εργαλεία.

Μπορείτε να ανοίξετε ένα υπάρχον αρχείο ή απλά να αρχίσετε να πληκτρολογείτε — δεν υπάρχει απαίτηση να ανοίξετε πρώτα ένα αρχείο.

Το πρόγραμμα επεξεργασίας

Το αριστερό πλαίσιο είναι ένα πλήρες πρόγραμμα επεξεργασίας κώδικα 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 της), αλλιώς δεν θα εμφανιστεί αλλού. Αυτό είναι το προεπιλεγμένο.
• Ενσωματωμένο — τα πραγματικά bytes της εικόνας γράφονται μέσα στο έγγραφο ως κείμενο (ένα μπλοκ data: base64), οπότε το αρχείο είναι εντελώς αυτόνομο: ένα αρχείο μεταφέρει τα πάντα, χωρίς τίποτα να χαθεί. Το αντάλλαγμα είναι το μέγεθος — το έγγραφο μεγαλώνει κατά το βάρος της εικόνας, και μια ενσωματωμένη εικόνα δεν μπορεί να χρησιμοποιήσει σχετική διαδρομή.

Επιλέξτε Ενσωματωμένη όταν θέλετε ένα ενιαίο φορητό αρχείο για παράδοση. Επιλέξτε Συνδεδεμένη όταν κρατάτε τις εικόνες δίπλα στο έγγραφο και θέλετε το αρχείο να παραμείνει μικρό.

Για μια συνδεδεμένη εικόνα, εμφανίζεται μια ακόμη επιλογή: Σχετική διαδρομή. Όταν η εικόνα βρίσκεται στον ίδιο φάκελο του εγγράφου (ή σε υποφάκελο), η επιλογή αυτή γράφει την αναφορά ως σύντομη σχετική διαδρομή αντί για πλήρη απόλυτη, οπότε ο σύνδεσμος συνεχίζει να λειτουργεί όταν μετακινείτε το έγγραφο και τις εικόνες του μαζί. Προσφέρεται μόνο όταν η εικόνα βρίσκεται μέσα στο φάκελο του εγγράφου — διαφορετικά δεν υπάρχει σχετική διαδρομή για να γραφτεί.

Οι ενσωματωμένες εικόνες παραμένουν τακτοποιημένες στον επεξεργαστή. Μια ενσωματωμένη εικόνα base64 είναι ένας μακρύς τοίχος κειμένου που διαφορετικά θα έθαβε τις γραμμές γύρω της, οπότε το Markzen διπλώνει την καθεμία σε ένα μικρό τσιπ που δείχνει τον τύπο και το μέγεθός της (για παράδειγμα 🖼 webp · 38 KB). Το τσιπ είναι μόνο για εμφάνιση — το υποκείμενο κείμενο παραμένει ανέγγιχτο, οπότε η αποθήκευση, η αντιγραφή ή η αποκοπή μεταφέρει πάντα την πλήρη εικόνα, και ο κέρσορας παρακάμπτει το τσιπ ως μία ενιαία μονάδα.

Αρχεία, καρτέλες & αποθήκευση

Το Markzen διατηρεί όσα έγγραφα θέλετε ανοιχτά ταυτόχρονα, το καθένα στη δική του καρτέλα, ώστε να μπορείτε να εργάζεστε σε πολλά αρχεία και να εναλλάσσεστε ελεύθερα μεταξύ τους. Δεν χρειάζεται να ανοίξετε ένα αρχείο για να ξεκινήσετε — αρχίστε να πληκτρολογείτε στο κενό έγγραφο που υπάρχει ήδη, ή χρησιμοποιήστε τα κουμπιά αρχείων της γραμμής εργαλείων:

• Νέο έγγραφο — ανοίγει ένα σύντομο μενού (Δημιουργία νέου) που παραθέτει τις οκτώ γλώσσες σήμανσης· επιλέξτε μία για να ξεκινήσετε ένα φρέσκο, κενό έγγραφο γραμμένο σε αυτή τη σήμανση, σε μια νέα καρτέλα.
• Άνοιγμα αρχείου Markdown — αναζητήστε ένα υπάρχον αρχείο και ανοίξτε το. Ο επιλογέας δέχεται και τις οκτώ μορφές σήμανσης, και το Markzen επιλέγει τη σωστή από την επέκταση του αρχείου. Ανοίγει στον φάκελο από τον οποίο πήρατε τελευταία φορά ένα έγγραφο, που θυμάται μεταξύ των συνεδριών, ώστε να μην ξεκινάτε από την αρχή κάθε φορά.
• Αποθήκευση — γράφει το ενεργό έγγραφο πίσω στο αρχείο του. Ένα έγγραφο που δεν έχει αποθηκευτεί ποτέ, μεταβαίνει στην Αποθήκευση Ως ώστε να μπορείτε να του δώσετε πρώτα ένα όνομα.
• Αποθήκευση ως — αποθηκεύει το ενεργό έγγραφο σε ένα νέο αρχείο, αφήνοντας ανέγγιχτο οποιοδήποτε πρωτότυπο.

Μπορείτε επίσης να σύρετε ένα αρχείο από τον διαχειριστή αρχείων σας και να το αποθέσετε στο παράθυρο για να το ανοίξετε.

Κάθε ανοιχτό έγγραφο είναι μια καρτέλα στην κορυφή του παραθύρου. Μια μη αποθηκευμένη καρτέλα επισημαίνεται με μια τελεία, και μια καρτέλα της οποίας η σήμανση δεν είναι Markdown φέρει ένα μικρό σήμα μορφής (για παράδειγμα adoc). Το × σε μια καρτέλα την κλείνει — και το κλείσιμο ενός εγγράφου με μη αποθηκευμένες αλλαγές δεν τις απορρίπτει ποτέ σιωπηλά: μια ενσωματωμένη γραμμή εμφανίζεται στην καρτέλα ώστε να μπορείτε να Αποθήκευση ή Απόρριψη πρώτα.

Ενώ ένα έγγραφο είναι ανοιχτό, το Markzen παρακολουθεί το αρχείο του στον δίσκο. Εάν το αρχείο αλλάξει σε άλλο πρόγραμμα και δεν έχετε δικές σας μη αποθηκευμένες επεξεργασίες, το Markzen τραβάει αυτόματα τη νέα έκδοση· εάν έχετε μη αποθηκευμένες επεξεργασίες, ρωτάει πρώτα — μια ενσωματωμένη γραμμή Επαναφόρτωση σας επιτρέπει να αποφασίσετε αν θα πάρετε την έκδοση στον δίσκο ή θα κρατήσετε τη δική σας.

Ζωντανή προεπισκόπηση

Το δεξί πλαίσιο είναι το έγγραφο που αποδίδεται ως στυλιζαρισμένο HTML, ενημερώνεται ζωντανά καθώς πληκτρολογείτε. Οι σύνδεσμοι λειτουργούν, οι πίνακες ευθυγραμμίζονται, ο κώδικας εμφανίζεται σε ένα μπλοκ μονοδιάστατης γραμματοσειράς, οι λίστες εργασιών αποκτούν πλαίσια ελέγχου, και κάθε μπλοκ επέκτασης απόδοσης (βλ. παρακάτω) σχεδιάζει τη φιγούρα του στη θέση της. Η προεπισκόπηση είναι μια πιστή εικόνα του πώς θα μοιάζει μια εξαγωγή HTML ή PDF.

Εάν ένα έγγραφο Markdown ανοίγει με ένα μπλοκ YAML front-matter — την ενότητα --- key: value --- που εργαλεία όπως το Jekyll, το Hugo και το Obsidian τοποθετούν στην κορυφή — το Markzen το αποδίδει ως μια τακτοποιημένη κάρτα μεταδεδομένων πάνω από το έγγραφο, αντί να αφήσει το κλείσιμο --- να μετατραπεί σε μια αδέσποτη επικεφαλίδα.

Λειτουργίες διάταξης

Μια ομάδα τριών κουμπιών της γραμμής εργαλείων καθορίζει τι εμφανίζει το παράθυρο:

• Διαιρεμένη προβολή — επεξεργαστής και προεπισκόπηση δίπλα-δίπλα. Σύρετε τον διαχωριστή για να αλλάξετε πόσο χώρο παίρνει το καθένα.
• Εμφάνιση επεξεργαστή — μόνο ο επεξεργαστής, γεμίζοντας το παράθυρο για γραφή χωρίς περισπασμούς.
• Εμφάνιση προεπισκόπησης — μόνο η προεπισκόπηση, ένας καθαρός αναγνώστης πλήρους πλάτους.

Πίνακας περιεχομένων

Το κουμπί Πίνακας περιεχομένων ανοίγει ένα πλαίσιο που δημιουργείται αυτόματα από κάθε επικεφαλίδα στο έγγραφο (#, ##, ###, …). Κάντε κλικ σε οποιαδήποτε καταχώριση για να μετακινηθεί η προεπισκόπηση σε αυτή την ενότητα. Οποιαδήποτε επικεφαλίδα με υπο-επικεφαλίδες κάτω από αυτή εμφανίζει ένα βέλος: κάντε κλικ σε αυτό για να Σύμπτυξη αυτή την ενότητα και να κρύψετε τις ένθετες επικεφαλίδες της, ή Ανάπτυξη για να τις επαναφέρετε — ώστε να μπορείτε να διπλώσετε ένα μακρύ περίγραμμα μόνο στα μέρη που εργάζεστε. Τα μικρά κουμπιά 2 / 3 / 4 στην κεφαλίδα του πίνακα περιορίζουν το περίγραμμα σε αυτό το βάθος επικεφαλίδας — χρήσιμο σε ένα μακρύ έγγραφο όταν θέλετε μόνο τα ανώτερα επίπεδα σε προβολή — και κάνοντας κλικ ξανά στο ενεργό φέρνει πίσω κάθε επίπεδο. Το πλαίσιο αλλάζει μέγεθος σύροντας την αριστερή του άκρη και συμπτύσσεται για να ελευθερώσει χώρο ανάγνωσης. Είναι ένα βοήθημα πλοήγησης μόνο μέσα στην εφαρμογή — δεν εμφανίζεται ποτέ σε εξαγωγή.

Παροχή του δικού σας περιγράμματος. Εάν οι επικεφαλίδες δεν είναι το περίγραμμα που θέλετε, ένα έγγραφο μπορεί να φέρει το δικό του. Ένα μπλοκ με περίφραξη με ετικέτα markzen του οποίου η πρώτη γραμμή είναι toc αντικαθιστά το δημιουργημένο πλαίσιο με τη λίστα που είναι γραμμένη κάτω από αυτό:

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

Η εσοχή καθορίζει το επίπεδο, και κάθε καταχώριση δείχνει σε μια άγκυρα που πρέπει να υπάρχει στο ίδιο το έγγραφο — μια επικεφαλίδα στην οποία δώσατε ένα ρητό id, ή ένα απλό <a id="intro"></a>. Το ίδιο το μπλοκ δεν σχεδιάζει τίποτα: είναι μεταδεδομένα που διαβάζει το πλαίσιο.

Πίνακες & υπολογιστικά φύλλα

Οι πίνακες μετακινούνται καθαρά μεταξύ του Markzen και οποιουδήποτε υπολογιστικού φύλλου. Επικολλήστε κείμενο διαχωρισμένο με tab — αντιγραμμένο από το Excel, τα Google Sheets, το Word, ή έναν πίνακα ιστού — στον επεξεργαστή και το Markzen το μετατρέπει σε έναν σωστό πίνακα γραμμένο στη σήμανση του ίδιου του εγγράφου, αντί να εισάγει έναν τοίχο από χαρακτήρες tab. Ο αναγνώστης επικόλλησης είναι ευαίσθητος σε εισαγωγικά (χειρίζεται σωστά κελιά που περιέχουν τα ίδια tabs, αλλαγές γραμμής ή εισαγωγικά) και ενεργοποιείται μόνο όταν το πρόχειρο περιέχει ένα καθαρό ορθογώνιο πλέγμα τουλάχιστον δύο στηλών· οτιδήποτε άλλο επικολλάται ως συνηθισμένο κείμενο.

Μπορείτε επίσης να ξεκινήσετε έναν πίνακα από το μηδέν. Το κουμπί Εισαγωγή πίνακα της γραμμής εργαλείων ανοίγει ένα μικρό πλέγμα — σύρετε πάνω του για να επιλέξετε πόσες γραμμές και στήλες θέλετε, και το Markzen γράφει έναν κενό πίνακα αυτού του μεγέθους στη σήμανση του ίδιου του εγγράφου, έτοιμο για πληκτρολόγηση. Η πρώτη γραμμή είναι η γραμμή κεφαλίδας.

Το αντίστροφο λειτουργεί επίσης. Περάστε το ποντίκι πάνω από οποιονδήποτε αποδοθέντα πίνακα στην προεπισκόπηση και ένα κουμπί αντιγραφής εμφανίζεται στη γωνία του: αντιγράφει τον πίνακα ως κείμενο διαχωρισμένο με tab που εισάγεται απευθείας σε ένα κελί υπολογιστικού φύλλου ή ένα έγγραφο Word. Αυτά τα κουμπιά αντιγραφής είναι μόνο μια ευκολία προεπισκόπησης — αφαιρούνται από κάθε εξαγωγή και μετατροπή, οπότε ένα κοινόχρηστο αρχείο περιέχει μόνο τον καθαρό πίνακα.

Επεκτάσεις απόδοσης

Το Markzen επεκτείνει την τυπική σήμανση μέσω περιφραγμένων μπλοκ κώδικα. Η ετικέτα γλώσσας αμέσως μετά τα αρχικά τριπλά backticks καθορίζει τον τρόπο απόδοσης του μπλοκ: μια ετικέτα που το Markzen αναγνωρίζει ως επέκταση σχεδιάζει μια ζωντανή φιγούρα αντί να εμφανίζει τον κώδικα.

Κάθε είδος φιγούρας σχεδιάζεται από τη δική του μηχανή απόδοσης, και το Markzen ανακτά μια μηχανή την πρώτη φορά που ένα έγγραφο την ζητάει πραγματικά αντί να τις φορτώνει όλες κατά την εκκίνηση — γι' αυτό η εφαρμογή ξεκινά σχεδόν αμέσως, και γι' αυτό το πρώτο διάγραμμα ενός συγκεκριμένου είδους μπορεί να χρειαστεί λίγο χρόνο για να εμφανιστεί, ενώ κάθε επόμενο είναι άμεσο.

Για παράδειγμα, αυτή η πηγή:

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

αποδίδεται ως ένα ζωντανό διάγραμμα ροής, όχι ως μια λίστα κώδικα — και παραμένει διάγραμμα ροής και στις εξαγωγές PDF και HTML.

Διαγράμματα, γραφήματα, μαθηματικά, μουσική σημειογραφία, σκακιέρες και πίνακες Go, κωδικοί QR και πολλά άλλα είναι ενσωματωμένα — το Συμβατότητα τα παραθέτει όλα με την ετικέτα τους.

Κάθε επέκταση έχει τη δική της ετικέτα γλώσσας (mermaid, chartjs, katex, abc, chess, …). Μπορείτε να αναμίξετε όσες θέλετε με συνηθισμένο κείμενο σε ένα μόνο έγγραφο — όλες αποδίδονται μαζί. Το αν μια φιγούρα παραμένει φιγούρα μόλις το έγγραφο φύγει από το Markzen εξαρτάται από το πού το στέλνετε — δείτε το Μετατροπή & εξαγωγή παρακάτω.

Τύποι μέσα σε μια πρόταση

Μια μαθηματική φόρμουλα μπορεί να είναι ένα μπλοκ από μόνη της — ένα μπλοκ katex ή asciimath, που στέκεται μόνο του και είναι κεντραρισμένο όπως μια εξίσωση σε ένα σχολικό βιβλίο. Αυτό λειτουργεί σε όλες τις οκτώ γλώσσες σήμανσης.

Μια φόρμουλα μπορεί επίσης να βρίσκεται μέσα σε μια πρόταση, έτσι ώστε "η περιοχή είναι π ρ τετράγωνο" να διαβάζεται ως μία γραμμή κειμένου με πραγματικά σύμβολα μέσα της. Αυτό εξαρτάται από το αν η γλώσσα σήμανσης έχει μια σημειογραφία για αυτό, και κάθε μία την γράφει διαφορετικά — η σημειογραφία ανά γλώσσα βρίσκεται στο Συμβατότητα.

Το Textile και το BBCode είναι οι δύο εξαιρέσεις, και αυτό είναι ένα όριο αυτών των γλωσσών και όχι του Markzen: καμία από τις δύο δεν όρισε ποτέ έναν τρόπο γραφής μαθηματικών. Σε ένα έγγραφο Textile ή BBCode μια φόρμουλα πρέπει επομένως να είναι ένα μπλοκ από μόνη της. Τίποτα δεν χάνεται — η φόρμουλα αποδίδεται, και επιβιώνει την εξαγωγή — απλά δεν μπορεί να υφανθεί σε μια γραμμή κειμένου.

Τοποθέτηση και μέγεθος μιας φιγούρας

Περάστε το ποντίκι πάνω από μια αποδοθείσα φιγούρα στην προεπισκόπηση και εμφανίζεται ένα μικρό πλαίσιο δίπλα της: κουμπιά στοίχιση (αριστερά, κέντρο, δεξιά) και — για τα είδη φιγούρων που μπορούν να αλλάξουν μέγεθος — πλαίσια πλάτος και ύψος σε pixel. Το remove style block τα διαγράφει ξανά.

Αυτή η επιλογή δεν διατηρείται κάπου αόρατα: το πλαίσιο την γράφει στο έγγραφο, ως ένα σύντομο μπλοκ με ετικέτα markzen τοποθετημένο αμέσως πριν από τη φιγούρα στην οποία εφαρμόζεται.

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

Έτσι, η διάταξη ταξιδεύει με το αρχείο — είναι μέρος αυτού που αποθηκεύετε, παραδίδετε και εξάγετε, σε οποιοδήποτε μηχάνημα. Μπορείτε εξίσου να γράψετε το μπλοκ με το χέρι: μία οδηγία ανά γραμμή, align (left, center ή right), width και height σε pixel, που εφαρμόζονται πάντα στο μπλοκ ακριβώς κάτω από αυτό.

Διαμόρφωση ενός εγγράφου με CSS

Ένα έγγραφο Markdown μπορεί επίσης να φέρει το δικό του φύλλο στυλ, σε ένα περιφραγμένο μπλοκ με ετικέτα style:

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

Οι κανόνες εφαρμόζονται στην προεπισκόπηση αυτού του εγγράφου και στις εξαγωγές του σε PDF και HTML, επιπλέον του ενεργού προτύπου στυλ — ένας τρόπος να δώσετε σε ένα έγγραφο τη δική του εμφάνιση χωρίς να αλλάξετε τις ρυθμίσεις σας για όλα τα άλλα. Μόνο συνηθισμένοι επιλογείς: οι κανόνες @ όπως @media και @keyframes δεν υποστηρίζονται, και το μπλοκ λειτουργεί μόνο σε έγγραφα Markdown.

Μετατροπή & εξαγωγή

Το μενού Μετατροπή σε της γραμμής εργαλείων είναι το σημείο όπου ένα ολοκληρωμένο έγγραφο φεύγει από το Markzen. Κάνει δύο διακριτά πράγματα.

Μετατροπή σε άλλη γλώσσα σήμανσης. Κάτω από το Ελαφριά σήμανση, ξαναγράψτε το ανοιχτό έγγραφο ως οποιαδήποτε από τις άλλες επτά σημάνσεις — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText ή Textile. Χρήσιμο όταν ένα wiki θέλει MediaWiki, ένα φόρουμ θέλει BBCode, ένας εκδότης θέλει AsciiDoc, ή μετακινείτε σημειώσεις μεταξύ οικοσυστημάτων. Κάθε μία από τις οκτώ εμφανίζεται μία φορά στο μενού, ως γλώσσα σήμανσης: ένα έγγραφο που αποθηκεύεται ως 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). Διαγράμματα, φόρμουλες και παρτιτούρες γράφονται ως εικόνες και φτάνουν άθικτα.
• Ως το αρχικό κείμενο του εγγράφου — κάθε άλλος προορισμός, και κάθε μετατροπή σε άλλη γλώσσα σήμανσης. Κείμενο, επικεφαλίδες, λίστες, πίνακες και σύνδεσμοι μετατρέπονται όλα· ένα μπλοκ mermaid ή katex φτάνει ως ένα συνηθισμένο μπλοκ κώδικα που περιέχει την πηγή που πληκτρολογήσατε, επειδή αυτές οι μορφές δεν έχουν φιγούρα για να τους δώσει το Markzen.

Έτσι, ένα έγγραφο που βασίζεται σε διαγράμματα είναι καλύτερο να παραδοθεί ως PDF, HTML, EPUB, Word, OpenDocument, PowerPoint ή RTF. Το LaTeX, το Typst, το reveal.js και τα υπόλοιπα σας δίνουν ακόμα ολόκληρο το έγγραφο — με την πηγή κάθε φιγούρας να παραμένει στη θέση της, έτοιμη για τα εργαλεία του δικού τους οικοσυστήματος.

Εξαγωγή από τη γραμμή εντολών

Το Markzen λειτουργεί επίσης χωρίς να ανοίξει παράθυρο. Περάστε το εκτελέσιμο του Markzen ένα αρχείο προέλευσης και -o με μια διαδρομή εξόδου, και αποδίδει το έγγραφο και γράφει την εξαγωγή απευθείας στο δίσκο:

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 είναι φτιαγμένο για να κάνει ένα έγγραφο να φαίνεται τυπογραφικά επεξεργασμένο και όχι γενικό. Οι έλεγχοι για αυτό βρίσκονται μαζί στη γραμμή εργαλείων πίσω από το κουμπί Στυλ και γραμματοσειρές, ώστε να μπορείτε να τους προσαρμόσετε ενώ διαβάζετε. Το θέμα και η γλώσσα της διεπαφής βρίσκονται στις Ρυθμίσεις → Εμφάνιση.

Πρότυπο στυλ

Το Στυλ προσφέρει πέντε στυλ προεπισκόπησης: Standard, GitHub, Book, Modern, Minimal. Το πρότυπο που επιλέγετε είναι επίσης το στυλ που εφαρμόζεται στις εξαγωγές PDF και HTML, οπότε καθορίζει πώς διαβάζεται ένα κοινόχρηστο έγγραφο — επιλέξτε Book ή Modern για κάτι που θα παραδώσετε, Minimal για ανάγνωση χωρίς περισπασμούς. Το πρότυπο διαμορφώνει μόνο την προεπισκόπηση, ποτέ τον επεξεργαστή.

Γραμματοσειρές

Τρεις επιλογείς στον ίδιο πίνακα ορίζουν μια ξεχωριστή γραμματοσειρά για κάθε είδος κειμένου — Επικεφαλίδα, Κείμενο και Κώδικας — κάτι που κάνει ένα έγγραφο Markzen να φαίνεται τυπογραφικά επεξεργασμένο:

• Επικεφαλίδα — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
• Κύριο κείμενο — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
• Κώδικας — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

Οι γραμματοσειρές κώδικα επιλέγονται για μια ιδιότητα πέρα από την εμφάνιση: όλες σχεδιάζουν τους χαρακτήρες σχεδίασης πλαισίων (│ ├ └ ─) από τους οποίους αποτελούνται οι λίστες δέντρων και τα διαγράμματα ASCII, έτσι ώστε ένα δέντρο καταλόγων που επικολλάται σε ένα μπλοκ κώδικα να διατηρεί το σχήμα του αντί να σπάει σε κενά. Είναι επίσης οι παραλλαγές χωρίς συνδέσμους — μια γραμματοσειρά με συνδέσμους ξανασχεδιάζει το != ως ένα μόνο ≠, κάτι που είναι ευχάριστο σε έναν επεξεργαστή κώδικα και λάθος σε ένα έγγραφο που προορίζεται να δείξει τι λέει πραγματικά το αρχείο. Οι JetBrains Mono και Source Code Pro περιλαμβάνονται στο Markzen, οπότε λειτουργούν σε ένα μηχάνημα που δεν τις έχει δει ποτέ και χωρίς καμία σύνδεση.

Μέγεθος κειμένου

Τα κουμπιά Μεγέθυνση κειμένου και Σμίκρυνση κειμένου της γραμμής εργαλείων αλλάζουν το μέγεθος του κειμένου.

Θέμα & γλώσσα

Στις Ρυθμίσεις → Εμφάνιση:

• Θέμα — Φωτεινό ή Σκοτεινό. Προεπιλογή: 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	διατάξεις πεδίων bit και byte
	QR Code	qrcode
	Railroad	railroad	διαγράμματα σύνταξης
	WaveDrom	wavedrom	διαγράμματα ψηφιακού χρονισμού
Μαθηματικά	KaTeX	katex	επίσης $…$ σε πρόταση — δείτε τον παραπάνω πίνακα
	AsciiMath	asciimath	σημειογραφία μαθηματικών απλού κειμένου
Γραφήματα	function-plot	fnplot	σχεδιάζει μια καμπύλη συνάρτησης
	JSXGraph	jsxgraph	διαδραστική γεωμετρία
	Plotly	plotly	επιστημονικά και 3-D γραφήματα
Επιστήμες	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, οπότε ρυθμίστε το πριν την εξαγωγή.
• Γράψτε στο markup που σας αρέσει, παραδώστε στη μορφή που χρειάζονται. Συντάξτε σε Markdown (ή σε οποιοδήποτε από τα οκτώ), και μετά χρησιμοποιήστε το Convert to για ένα αρχείο Word, μια παρουσίαση, ένα ebook ή μια πηγή LaTeX – χωρίς να απαιτούνται ξεχωριστά εργαλεία.