markdown here herunterladen - markdown here Quellcode herunterladen

markdown here

Anderer Quellcode

v2.14.2

Herunterladen

Markdown hier

Besuchen Sie die Website.
Holen Sie es sich für Chrome.
Holen Sie es sich für Firefox.
Holen Sie es sich für Safari.
Holen Sie es sich für Thunderbird.
Holen Sie es sich für Opera.
Diskutieren Sie darüber und stellen Sie Fragen in den GitHub-Diskussionen.

Markdown Here ist eine Erweiterung für Google Chrome, Firefox, Safari, Opera und Thunderbird, mit der Sie E-Mails ^† in Markdown ^‡ schreiben und vor dem Senden rendern können. Es unterstützt auch die Syntaxhervorhebung (geben Sie einfach die Sprache in einem umzäunten Codeblock an).

Das Schreiben einer E-Mail mit Code darin ist ziemlich mühsam. Markdown mit darin enthaltenem Code zu schreiben ist einfach. Ich habe E-Mails in Markdown im Browser-Editor von GitHub geschrieben und dann die Vorschau in eine E-Mail kopiert. Das ist ein ziemlich absurder Arbeitsablauf, deshalb habe ich beschlossen, ein Tool zu erstellen, um Markdown direkt in der E-Mail zu schreiben und zu rendern.

Um herauszufinden, was mit Markdown in Markdown Here gemacht werden kann, schauen Sie sich das Markdown Here Cheatsheet und die anderen Wiki-Seiten an.

^{†: Und Google Groups-Beiträge, Blogger-Beiträge, Evernote-Notizen und Wordpress-Beiträge! Mehr sehen.}
^{‡: Und mathematische TeX-Formeln!}

Inhaltsverzeichnis

Installationsanweisungen
Gebrauchsanweisung
Fehlerbehebung
Kompatibilität
Notizen und Sonstiges
Erstellen der Erweiterungspakete
Nächste Schritte, Credits, Feedback, Lizenz

Installationsanweisungen

Chrom

Chrome Web Store

Gehen Sie zur Chrome Web Store-Seite für Markdown Here und installieren Sie es normal.

Stellen Sie nach der Installation sicher, dass Sie Ihr Webmail neu laden oder Chrome neu starten!

Handbuch/Entwicklung

Klonen Sie dieses Repo.
Öffnen Sie in Chrome die Erweiterungseinstellungen. (Schraubenschlüssel-Schaltfläche, Extras, Erweiterungen.)
Klicken Sie auf der Seite mit den Erweiterungseinstellungen auf das Kontrollkästchen „Entwicklermodus“.
Klicken Sie auf die jetzt sichtbare Schaltfläche „Entpackte Erweiterung laden…“. Navigieren Sie zu dem Verzeichnis, in dem Sie das Repo geklont haben, und dann zum Verzeichnis src darunter.
Die Markdown Here -Erweiterung sollte jetzt in Ihrer Erweiterungsliste sichtbar sein.
Laden Sie Ihre Webmail-Seite (und möglicherweise Ihre Anwendung) neu, bevor Sie versuchen, eine E-Mail zu konvertieren.

Firefox und Thunderbird

Mozilla-Add-ons-Seite

Gehen Sie zur Firefox-Add-ons-Seite für Markdown Here und installieren Sie es normal.

Oder gehen Sie zum Menü „Extras > Add-ons“ und suchen Sie dann nach „Markdown Here“.

Stellen Sie nach der Installation sicher, dass Sie Firefox/Thunderbird neu starten!

Hinweis: Es dauert bis zu einem Monat, bis Mozilla Änderungen an der Firefox/Thunderbird-Erweiterung genehmigt, sodass Updates (Funktionen, Korrekturen) hinter den hier gezeigten zurückbleiben. Sie können manuell aus der Liste der Versionen auswählen, ob Sie die neueste Version installieren möchten, bevor sie überprüft wird: https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/

Handbuch/Entwicklung

Klonen Sie dieses Repo.
Befolgen Sie die Anweisungen im MDN-Artikel „Ihre erste WebExtension“.

Safari

Laden Sie die Erweiterung direkt herunter. Wenn der Download abgeschlossen ist, doppelklicken Sie zur Installation darauf.

Präferenzen

Um zu den Markdown Here-Einstellungen zu gelangen, öffnen Sie die Safari-Einstellungen und gehen Sie dann zur Registerkarte „Erweiterungen“. Klicken Sie dann auf das Feld „Klicken Sie auf mich, um die Markdown-Optionen hier anzuzeigen“.

Oper

Beachten Sie, dass Markdown Here nur mit Opera-Versionen 16 und höher funktioniert (also denen, die auf Chromium basieren).

Gehen Sie zur Opera-Add-ons-Store-Seite für Markdown Here und installieren Sie es normal.

Stellen Sie nach der Installation sicher, dass Sie Ihr Webmail neu laden oder Chrome neu starten!

Gebrauchsanweisung

Installieren Sie es und dann ...

Stellen Sie in Chrome/Safari/Opera sicher , dass Sie Ihre Webmail-Seite neu laden, bevor Sie versuchen, Markdown Here zu verwenden.
Melden Sie sich in Chrome/Firefox/Safari/Opera bei Ihrem Gmail-, Hotmail- oder Yahoo-Konto an und starten Sie eine neue E-Mail. Starten Sie in Thunderbird eine neue Nachricht.
Stellen Sie sicher, dass Sie den Rich-Editor verwenden.
- Klicken Sie in Gmail auf den Link „Rich-Formatierung“, sofern dieser sichtbar ist.
- Stellen Sie in Thunderbird sicher, dass „Nachrichten im HTML-Format verfassen“ im Bereich „Verfassen und Adressierung“ in Ihren „Kontoeinstellungen“ aktiviert ist.

Verfassen Sie eine E-Mail in Markdown. Zum Beispiel:

 **Hallo** `Welt`.

„Javascript
Alert('Hallo Syntaxhervorhebung.');
„

Klicken Sie mit der rechten Maustaste in das Erstellungsfeld und wählen Sie im Kontextmenü den Eintrag „Markdown Toggle“. Oder klicken Sie auf die Schaltfläche, die in Ihrer Adressleiste angezeigt wird. Oder verwenden Sie den Hotkey (standardmäßig STRG + ALT + M ).
Ihre E-Mail sollte von Markdown korrekt in Rich HTML gerendert werden.
Senden Sie Ihre tolle E-Mail an alle, die Sie kennen. Für sie wird es genauso erscheinen wie für Sie.

Kehren Sie zu Markdown zurück

Nachdem Sie Ihren Markdown in hübsches HTML gerendert haben, können Sie immer noch zu Ihrem ursprünglichen Markdown zurückkehren. Klicken Sie einfach mit der rechten Maustaste auf eine beliebige Stelle im neu gerenderten Markdown und klicken Sie auf „Markdown umschalten“. Der Text zum Verfassen Ihrer E-Mail wird wieder in den Markdown umgewandelt, den Sie geschrieben haben.

Beachten Sie, dass alle Änderungen, die Sie am hübschen HTML vornehmen, verloren gehen, wenn Sie zu Markdown zurückkehren.

In Gmail können Sie auch den Befehl „Rückgängig“ des Browsers verwenden ( STRG + Z / CMD + Z oder über das Menü „Bearbeiten“). Seien Sie gewarnt, dass Sie möglicherweise auch die letzten eingegebenen Zeichen verlieren.

Antworten

In Gmail, Thunderbird und Google Groups können Sie „Markdown Toggle“ wie gewohnt verwenden: Schreiben Sie einfach Ihre Antwort (oben, unten, inline, wo auch immer) und konvertieren Sie sie dann. Die ursprüngliche E-Mail, auf die Sie antworten, bleibt erhalten. (Technisch gesehen: Vorhandene blockquote Blöcke bleiben erhalten.)

In Hotmail und Yahoo (die das Original nicht in ein blockquote einfügen) und optional in Gmail, Thunderbird und Google Groups können Sie sicherstellen, dass nur der Teil der Antwort konvertiert wird, den Sie geschrieben haben, indem Sie auswählen, was Sie konvertieren möchten und dann auf „Markdown Toggle“ klicken – siehe nächster Abschnitt.

Auswahl/stückweise Konvertierung

Manchmal möchten Sie nicht die gesamte E-Mail konvertieren; Manchmal ist Ihre E-Mail nicht vollständig Markdown. Um nur einen Teil der E-Mail zu konvertieren, wählen Sie den Text aus (mit Ihrer Maus oder Tastatur), klicken Sie mit der rechten Maustaste darauf und klicken Sie auf den Menüpunkt „Markdown Toggle“. Ihre Auswahl wird auf magische Weise in hübsches HTML umgewandelt.

Um zu Markdown zurückzukehren, platzieren Sie einfach Ihren Cursor an einer beliebigen Stelle im Block des konvertierten Texts, klicken Sie mit der rechten Maustaste und klicken Sie erneut auf den Menüpunkt „Markdown Toggle“. Jetzt ist es auf magische Weise zurück zum ursprünglichen Markdown.

Wissenswertes zum Konvertieren/Zurücksetzen einer Auswahl

Wenn Sie nur einen Teil eines Textblocks auswählen, wird nur dieser Text konvertiert. Der konvertierte Block wird in ein Absatzelement eingeschlossen, sodass die ursprüngliche Zeile unterbrochen wird. Sie möchten das wahrscheinlich nie tun.
Sie können mehrere konvertierte Blöcke gleichzeitig auswählen und rückgängig machen. Ein Ergebnis davon ist, dass Sie Ihre gesamte E-Mail auswählen, auf „Markdown Toggle“ klicken können und alle Teile davon, die Sie konvertiert haben, zurückgesetzt werden.
Wenn Sie beim Klicken auf „Markdown Toggle“ nichts ausgewählt haben, prüft Markdown Here, ob irgendwo in der Nachricht konvertierte Blöcke vorhanden sind, und setzt diese zurück. Wenn keine konvertierten Blöcke gefunden werden, wird die gesamte E-Mail konvertiert.

Optionen

Auf die Seite „Markdown Here -Optionen“ kann über die Chrome-, Firefox-, Safari- oder Thunderbird-Erweiterungsliste zugegriffen werden. Zu den verfügbaren Optionen gehören:

Stiländerungen für den gerenderten Markdown.
Syntaxhervorhebung der Themenauswahl und -änderung.
Aktivierung und Anpassung der Verarbeitung mathematischer TeX-Formeln.
Was der Hotkey sein sollte.

Bei Chrome und Firefox werden alle in den Markdown Here- Optionen vorgenommenen Änderungen automatisch zwischen Ihren anderen Installationen dieses Browsers synchronisiert (sofern Sie die Synchronisierungsfunktion im Browser aktiviert haben).

Fehlerbehebung

Weitere Informationen finden Sie auf der Wiki-Seite zur Fehlerbehebung.

Kompatibilität

Weitere Informationen finden Sie auf der Kompatibilitäts-Wiki-Seite.

Notizen und Sonstiges

Markdown Here verwendet Github Flavored Markdown, mit der Einschränkung, dass GFM-Speziallinks nicht unterstützt werden (Problem Nr. 11); Dies wird auch nicht der Fall sein, da MDH nicht Github-spezifisch ist.
Verfügbare Sprachen für die Syntaxhervorhebung (und die Art und Weise, wie sie in den eingezäunten Codeblock geschrieben werden sollten) können auf der Highlight.js-Demoseite eingesehen werden.
In Ihren Markdown eingebettete Bilder bleiben erhalten, wenn Sie „Markdown umschalten“. Mit Gmail können Sie Bilder in Ihre E-Mail einfügen – das kann viel einfacher sein, als auf ein externes Bild zu verweisen.
E-Mail-Signaturen werden automatisch von der Konvertierung ausgeschlossen. Insbesondere bleibt alles nach dem halbstandardisierten '-- ' (beachten Sie das Leerzeichen am Ende) in Ruhe.
- Beachten Sie, dass Hotmail und Yahoo das '-- ' nicht automatisch zu Signaturen hinzufügen. Sie müssen es also selbst hinzufügen.
Der Menüpunkt „Markdown Toggle“ wird für mehr Elementtypen angezeigt, als er korrekt rendern kann. Dies soll den Leuten klar machen, dass sie keinen Rich-Editor verwenden. Sonst sehen sie den Menüpunkt einfach nicht und wissen nicht warum.
Styling:
- Die Verwendung browserspezifischer Stile (-moz-, -webkit-) sollte vermieden werden. Wenn sie verwendet werden, werden sie für Personen, die die E-Mail in einem anderen Browser als dem, an den die E-Mail gesendet wurde, lesen, möglicherweise nicht korrekt dargestellt.
- Die Verwendung von zustandsabhängigen Stilen (wie a:hover ) funktioniert nicht, da sie zum Zeitpunkt der expliziten Angabe der Stile nicht übereinstimmen. (In E-Mails müssen Stile explizit auf alle Elemente angewendet werden – Stylesheets werden entfernt.)
Weitere Optimierungsfunktionen finden Sie im Abschnitt „Tipps und Tricks“.

Erstellen der Erweiterungspakete

 cd utils
node build.js

Erweiterung für Chrome, Opera und Firefox (WebExtension).

Erstellen Sie eine Datei mit der Erweiterung .zip , die diese Dateien und Verzeichnisse enthält:

 manifest.json
common/
chrome/
_locales

Thunderbird (XUL)-Erweiterung

Erstellen Sie eine Datei mit der Erweiterung .xpi , die diese Dateien und Verzeichnisse enthält:

 chrome.manifest
install.rdf
common/
firefox/

Safari-Erweiterung

Der browserspezifische Code befindet sich im Projekt markdown-here-safari .

Verwenden Sie den Safari Extension Builder.

Nächste Schritte

Sehen Sie sich die Problemliste und das Notes-Wiki an. Alle Ideen, Fehler, Pläne, Beschwerden und Träume landen an einem dieser beiden Orte.

Sie können gerne ein Feature-Request-Problem erstellen, wenn das, was Sie möchten, noch nicht vorhanden ist. Wenn Sie eine weniger formelle Herangehensweise an die Verbreitung einer Idee bevorzugen, posten Sie sie in unseren GitHub-Diskussionen.

Es erfordert auch einiges an Arbeit, um in allen Anwendungen und Websites, auf denen Markdown Here funktioniert, über die neuesten Änderungen auf dem Laufenden zu bleiben.

Credits

Markdown Here wurde auf den Schultern von Giganten codiert.

Markdown-zu-HTML: chjj/marked
Syntaxhervorhebung: isagalaev/highlight.js
HTML-zu-Text: mtrimpe/jsHtmlToText

Rückmeldung

Alle Fehler, Funktionswünsche, Pull-Anfragen, Rückmeldungen usw. sind willkommen. Erstellen Sie ein Problem. Oder posten Sie es in unseren GitHub-Diskussionen.