Απόδοση διαγραμμάτων Mermaid
Αποδώστε κώδικα διαγραμμάτων Mermaid, όπως διαγράμματα ροής, ακολουθίας, κλάσεων, καταστάσεων, Gantt και πίτας, σε SVG ή εικόνα PNG υψηλής ανάλυσης, με το προεπιλεγμένο, ουδέτερο, σκούρο ή δασικό θέμα.
Συχνές ερωτήσεις
Τι είναι το Mermaid;
Μια σύνταξη κειμένου για διαγράμματα: περιγράφετε κόμβους και συνδέσεις σε γραμμές κώδικα και το Mermaid σχεδιάζει το διάγραμμα. Τα GitHub, GitLab, το Notion, το Obsidian και πολλά εργαλεία τεκμηρίωσης το αποδίδουν.
Ποιοι τύποι διαγραμμάτων υποστηρίζονται;
Ό,τι υποστηρίζει το Mermaid 12, όπως διαγράμματα ροής, ακολουθίας, κλάσεων, καταστάσεων, σχέσεων οντοτήτων, διαδρομής χρήστη, Gantt, πίτας, νοητικών χαρτών, git γράφων και τεταρτημορίων.
SVG ή PNG;
Το SVG είναι μικρό, παραμένει ευκρινές σε κάθε μέγεθος και λειτουργεί σε ιστοσελίδες και εργαλεία σχεδίασης. Το PNG είναι κατάλληλο για διαφάνειες, συνομιλίες και έγγραφα· η ρύθμιση κλίμακας το αποδίδει σε ανάλυση 1x, 2x ή 3x.
Γιατί εμφανίζεται σφάλμα σύνταξης;
Το Mermaid δεν μπόρεσε να αναλύσει τον κώδικα. Το μήνυμα δείχνει τη γραμμή όπου σταμάτησε η ανάλυση· συνηθισμένες αιτίες είναι ένα βέλος που λείπει, μη ισορροπημένες αγκύλες ή μια λέξη-κλειδί τύπου διαγράμματος με ορθογραφικό λάθος.
Εκτελούνται σύνδεσμοι και σκριπτ στα διαγράμματα;
Όχι. Τα διαγράμματα αποδίδονται με το αυστηρό επίπεδο ασφάλειας του Mermaid, επομένως οι χειριστές κλικ και τα σκριπτ είναι απενεργοποιημένα και οι ετικέτες καθαρίζονται. Η μηχανή απόδοσης δεν μπορεί να φορτώσει τίποτα από το δίκτυο.
Πόσο μεγάλο μπορεί να είναι ένα διάγραμμα;
Έως 20,000 χαρακτήρες κώδικα Mermaid. Πολύ μεγάλα διαγράμματα ενδέχεται να απορριφθούν ως PNG σε υψηλή κλίμακα· χρησιμοποιήστε SVG ή χαμηλότερη κλίμακα.