Ein guter Editor für technische Tutorials auf dem Mac?

Ich schreibe viele Tutorials und veröffentliche sie als HTML. Normalerweise gebe ich sie direkt in HTML ein, aber jedes Mal, wenn ich <code>Tags verwende, um ein Codebeispiel anzuzeigen, muss ich den Inhalt der Tags manuell aktualisieren (z. B. in ändern >) &gt;.

Derzeit verwende ich TextMate 2, suche aber nach einer effizienteren Möglichkeit, dies auf dem Mac zu tun. Wie würden Sie vorgehen (Markdown?) und welche Software würden Sie verwenden?

Vielen Dank!

Benötigen Sie einen Import/Export in das/aus dem HTML-Format?
Export nach HTML, ja. Laut meiner Antwort macht Mou es perfekt.

Antworten (6)

Ich würde Ihnen ReText empfehlen , wie in meiner Antwort hier beschrieben :

ReText mit Live-Vorschau
ReText mit Live-Vorschau (Quelle: ReText; Bild anklicken für größere Variante)

  • Es ist für OSX verfügbar
  • Es verfügt über eine Live-Vorschau, sodass Sie die Ergebnisse Ihrer Eingabe sehen, während Sie tippen
  • Es unterstützt eine Reihe von Dialekt- und anderen Addons, wie z. B. "Codelite" zum Hervorheben von Code
  • Kein Gefummel mit HTML (außer wenn Sie es wünschen), sondern die Verwendung von Markdown (wie hier auf SE verwendet)
  • Es kann Ihre Texte als HTML, ODT (Open Document Text, zB für OpenOffice/LibreOffice), PDF exportieren

Ich benutze es selbst seit einiger Zeit und bin sehr zufrieden damit: glatt und stabil.

Ich würde vorschlagen, dass Sie Ihr Dokument zuerst in umstrukturiertem Text bearbeiten und ein Tool wie pandoc verwenden , um die endgültige(n) Version(en) zu erstellen .

Dadurch können Sie Ihre Arbeitsdateien in einem für die Versionskontrolle geeigneten Format minimieren und gleichzeitig Ausgaben in einem oder allen der folgenden Formate erstellen: asciidoc, beamer, context, docbook, docx, dzslides, epub, epub3, fb2, html, html5, json, latex, mann, markdown, markdown_github, markdown_mmd, markdown_phpextra, markdown_strict, mediawiki, nativ, odt, opendocument, opml, org, pdf*, schlicht, offenbarenjs, rst, rtf, s5, slideous, slidy, texinfo, textil.

AsciiDoc

Dr. Matt Neuburg , einer der besten lebenden technischen Redakteure, erstellt riesige Wälzer mit AsciiDoc ( Wikipedia-Artikel ) und jedem beliebigen Texteditor. AsciiDoc ähnelt Markdown und ist semantisch äquivalent zu DocBook XML .

Lesen Sie seinen Blogbeitrag , in dem er erklärt, wie er arbeitet.

AsciiDoc kann in verschiedenen Formaten ausgeben, darunter HTML , PDF , EPUB , Manpage .

Sie können MacDown ausprobieren . Es funktioniert unter macOS Sierra, wo Mou dies nicht tut. Es ist ein idealer Editor für Entwickler, wie z. B. technische Tutorials, da es die Syntaxhervorhebung unterstützt (durch Aktivieren des Codeblocks mit Syntaxhervorhebung im Bereich „ Rendereinstellungen “ ). Hier ist die vollständige Liste der unterstützten Codeblock-Syntaxen . Die Software ist Open Source, kostenlos nutzbar und unter der MIT-Lizenz veröffentlicht.

MacDown, Markdown-Editor für macOS

Verwandte: Markdown-Editor für OSX, der eine Vorschau enthält, idealerweise in Echtzeit?

Danke für die Antworten. Nachdem ich beide bewertet hatte, entschied ich mich, Markdown zum Schreiben der Lektionen zu verwenden, wobei ich Mou als Texteditor verwendete. Es tut alles, was ich brauche, ist kostenlos und erlaubt mir dann, copy to HTML.

Ich verwende die Web-App StackEdit , um Blog-Posts, Gist-Tutorials und Stack Exchange-Antworten zu verwalten. Es ist ein Markdown-Editor und hat diese relevanten Funktionen:

  • Funktioniert offline

  • Mit Google Drive und Dropbox synchronisieren, dh auf Desktop und Tablet bearbeiten

  • Veröffentlichung in den folgenden Diensten

    blogger, github, wordpress, andere

  • Exportieren Sie die Formate

    Markdown, HTML, Vorlage, PDF

  • Kopieren Sie den HTML-Code direkt aus dem Editor