Wie kann ich Markdown-Dokumente massenweise in HTML konvertieren?

Question

Ich schreibe eine Dokumentation in Markdown und erstelle für jeden Abschnitt der Dokumentation eine eigene Datei. Ich würde gerne alle Dateien in einem Rutsch in HTML konvertieren, aber ich kann niemanden finden, der das Gleiche versucht hat. Ich arbeite mit einem Mac, also sollte ein einfaches Bash-Skript ausreichen, um das zu bewerkstelligen, aber ich habe noch nie etwas in Bash gemacht und hatte kein Glück. Es scheint, dass es einfach sein sollte, etwas zu schreiben, das ich einfach ausführen kann:

markdown-batch ./*.markdown

Irgendwelche Ideen?

Answer 1

Verwenden Sie pandoc - ist ein Kommandozeilenprogramm, mit dem Sie von einem Format in ein anderes konvertieren können. Dieses Tool unterstützt Markdown zu HTML und zurück.

Um z.B. HTML aus Markdown zu erzeugen, führen Sie aus:

pandoc -f markdown index.md > index.html

Answer 2

So würden Sie es in der Bash machen.

for i in ./*.markdown; do perl markdown.pl --html4tags $i > $i.html; done;

Natürlich brauchen Sie die Markdown-Skript .

Answer 3

Sie können dies ganz einfach tun mit VS-Code . (Das ist zwar kein Kommandozeilentool, aber es hat sich als sehr hilfreich erwiesen).

• Installieren Sie die Markdown Alles in Einem Erweiterung durch Yu Zhang
• Öffnen Sie die VS Code Befehlspalette ( Ctrl-Shift-P ), und wählen Sie Markdown All In One: Print documents to HTML (select a source folder)

• Tipp : Wenn Sie Ihren Export portabel machen wollen, müssen Sie die absoluten Bildpfade in relative Pfade umwandeln, indem Sie die folgende Einstellung in Ihrem settings.json ( Ctrl-Shift-P -> Preferences: Open Settings (JSON) )

  "markdown.extension.print.absoluteImgPath": false

Auf diese Weise brauchen Sie nach der Konvertierung nur alle Nicht-Markdown-Dateien (Bilder) in den Zielordner zu kopieren, und die HTML-Seiten sind portabel.

Answer 4

Ich verwende dies in einer .bat-Datei:

@echo off
for %i in (*.txt) python markdown.py "%i"

Answer 5

// Bash auf dem Mac verwenden

for i in *.md; do asciidoc  $i;  done;