markdown guide beginner tutorial

Was ist Markdown? Ein einfacher Leitfaden für Anfänger

Ein Anfängerführer zu Markdown was es ist, warum es geschaffen wurde, wo es verwendet wird und wie man heute anfängt, es zu schreiben. Vorerfahrung ist nicht erforderlich.

W
WordToMD-Team
·

Markdown ist eine leichte Textformatierungs-Syntax, die einfachen Text in strukturierte Dokumente verwandelt. Es wurde 2004 von John Gruber erstellt und ist mittlerweile das Standardformat für Dokumentation, README-Dateien, Blog-Posts und Entwicklerkommunikation. Dieser Leitfaden erklärt, was Markdown ist, warum Menschen es verwenden und wie man anfängt.

Was ist Markdown?

Markdown ist eine Möglichkeit, Formatierung an einfachen Text mit einfachen Interpunktionszeichen hinzuzufügen. Sie schreiben in einem Texteditor, und das Markdown wird von einem Prozessor in formatierte Ausgabe (HTML, PDF usw.) gerendert.

Zum Beispiel:

# This is a Heading

This is a **bold word** and this is *italic*.

- List item one
- List item two

Darstellungen wie folgt:

Dies ist eine Überschrift

Das ist ein Wort mit fettem Wort Und das ist ... italic.

  • Liste Nummer eins
  • Liste Nummer zwei

Die Formatierung lebt im Text selbst kein verstecktes XML, kein binäres Format, keine proprietäre Codierung.

Warum wurde Markdown erschaffen?

Vor Markdown standen Web-Autoren vor einer Wahl: Schreiben Sie in rohem HTML (langweilig und fehleranfällig) oder verwenden Sie einen WYSIWYG-Editor, der unordentlichen Code erzeugte. John Gruber entwarf Markdown als:

  1. Lesbar wie vorhanden Auch ohne Wiedergabe, **bold** Lesen Sie klar als Betonung
  2. Von jedermann schreibbar Keine spezielle Software, nur ein Texteditor
  3. Umwandelbar in HTML Das primäre Ausgabeformat

Die ursprüngliche Spezifikation konzentrierte sich auf die Herstellung von sauberem HTML. Aber Markdown hat sich seitdem auf Dutzende von Plattformen und Ausgabeformaten ausgebreitet.

Wo wird Markdown verwendet?

Markdown ist überall in der Technologie:

PlattformWas Markdown tut
GitHubREADME, Probleme, Pull-Anfragen, Wikis
NotionSeiteninhalt und Dokumente
ObsidianAlle Notizen im Tresor .
WordPress-NachrichtenVeröffentlichungen über Markdown Plugin
GitBookDokumentationsseiten
Nachlässigkeit / ZwietrachtNachrichtenformatierung
Stack-ÜberflussFragen und Antworten
Jekyll , Hugo und Astro .Blogbeiträge und statische Seiten
Jupiter-NotebooksDokumentationszellen

Wenn Sie technische Inhalte schreiben, haben Sie mit ziemlicher Sicherheit auf Markdown gestoßen.

Markdown gegen Word: Hauptunterschiede

AspektWordMarkdown
FormateBinär (.docx)Einfacher Text (.md)
ÜbertragbarkeitErfordert Word oder eine kompatible AppÖffnet sich in jedem Texteditor
VersionssteuerungSchwierig (binäre Differenzen)Einfach (Git-Differenzen Zeile für Zeile)
RenderingIn der App integriertErfordert einen Markdown-Renderer
LernkurveWYSIWYG (ohne Lernen)Erfordert das Lernen der Syntax
PlattformunterstützungMicrosoft-ÖkosystemUniversale Entwicklerwerkzeuge

Wenn Sie Word Dokumente haben, die Sie in Markdown konvertieren möchten, WordToMD Handhabt das sofort. Keine Anmeldung, kein Upload.

Grundlegende Markdown Syntax

Hier sind die häufigsten Elemente:

Rubriken

# Heading 1
## Heading 2
### Heading 3

Sehen Sie Markdown Leitfaden für Überschriften für die vollständige Referenz.

Betonung

**Bold text**
*Italic text*
~~Strikethrough~~

Verzeichnisse

- Unordered item
- Another item
  - Nested item

1. First
2. Second
3. Third
[Link text](https://example.com)

Bilder

![Alt text](image.png)

Kodex

Inline: `code snippet`

Block:
```python
print("Hello, Markdown!")

See [Markdown Code Blocks Guide](/blog/markdown-code-blocks-guide).

### Tables

```markdown
| Name | Role |
|---|---|
| Alice | Developer |
| Bob | Designer |

Sehen Sie Markdown Tabellen: Eine vollständige Anleitung.

Blockquoten

> This is a blockquote.
> It can span multiple lines.

Markdown Geschmacksrichtungen

Markdown ist kein einziger Standard es gibt mehrere Varianten:

  • CommonMark Eine strenge und eindeutige Spezifikation
  • GitHub Geschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmacksschmack CommonMark + Tabellen, Aufgabenlisten, Durchschlag, automatische Links
  • MultiMarkdown (Mehrmarkierung) Fügt Fußnoten, Zitate und Metadaten hinzu
  • Das ist der richtige Weg. Am reichsten an Funktionen, verwendet durch den Pandoc-Konverter

Die meisten Plattformen unterstützen mindestens CommonMark. GitHub, Obsidian und GitBook verwenden GFM. Für eine vollständige Referenz siehe Markdown Syntax Kurzübersicht.

Wie man Markdown schreibt

Sie brauchen keine spezielle Software. Zu den Optionen gehören:

  • VS-Code Kostenloser, leistungsfähiger Editor mit eingebauter Markdown-Vorschau
  • Obsidian Markdown Notizen-App mit Grafikansicht
  • Typora WYSIWYG Markdown-Editor
  • iA Verfasser Fokussierte Schreibumgebung
  • Jeder einfache Texteditor Notepad, TextEdit, vim, Emacs

Konvertieren zwischen Markdown und anderen Formaten

Wenn Sie Word Dokumente zu Markdown konvertieren, WordToMD macht es in Sekunden völlig kostenlos, ohne Datei hochladen.

Umgekehrt (Markdown zu Word oder PDF) verarbeiten Tools wie Pandoc diese Umwandlung. Sehen Sie Pandoc Word bis Markdown für Einrichtungsanweisungen.

FAQ

Ist Markdown eine Programmiersprache? - Nein, ich kann nicht. Markdown ist eine Markup-Sprache sie beschreibt Formatierung, nicht Logik oder Berechnung.

Kann ich Markdown in Microsoft Word verwenden? Word stellt Markdown nicht nativ dar, aber es gibt Word Add-Ins, die Markdown-Unterstützung hinzufügen. Alternativ konvertieren Sie Word in Markdown mit WordToMD und verwenden Sie einen Markdown-Editor.

Ist Markdown gut für lange Dokumente? Ja, mit einer guten Kursstruktur. Sehr lange Dokumente profitieren von der Aufteilung in mehrere Dateien (wie in GitBook- oder Obsidian-Wölben).

Welche Dateierweiterung verwendet Markdown? .md ist der Standard. .markdown ist ebenfalls gültig. Einige Plattformen verwenden .mdx für Markdown mit JSX (React) Komponenten.

Schlußfolgerung

Markdown ist ein einfaches, leistungsfähiges Format, das zur lingua franca des technischen Schreibens geworden ist. Es ist als einfacher Text lesbar, rendert wunderschön und funktioniert mit jedem wichtigen Entwickler-Tool. Wenn Sie neu sind, beginnen Sie mit dem Markdown Syntax Kurzübersicht und versuchen Sie, Ihr erstes Word-Dokument zu konvertieren WordToMD.