In Markdown schreiben

Markdown eignet sich gut für Forschungsnotizen, Berichte und frühe Entwürfe. Oleafly bietet ihm eine eigene Formatierungsleiste und einen Pandoc-Build-Pfad, mit Quelldateien, die Sie außerhalb der App verwenden können.

Einen Bericht erstellen

1. Wählen Sie Neues Projekt → Eine Vorlage verwenden → Leeres Markdown-Dokument.
2. Nennen Sie das Projekt Feldnotizen und öffnen Sie main.md.
3. Fügen Sie dieses Beispiel ein und wählen Sie dann Neu kompilieren oder drücken Sie ⌘Enter / Ctrl+Enter.
4. Wenn Oleafly anbietet, eine benötigte Engine einzurichten, schließen Sie dieses Setup ab und kompilieren Sie erneut.

main.md

---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.

Das PDF sollte einen Titel, Überschriften, eine nummerierte Liste und eine Tabelle enthalten. Die Metadaten zwischen dem ersten Paar ----Zeilen steuern Dokumenttitel und Autor.

Quelltext- und visuelle Bearbeitung

Der Umschalter am Anfang der Werkzeugleiste hat drei Modi. Code bearbeitet das Markdown direkt. Visuell bietet formatierte Bearbeitung für Überschriften, Absätze, Listen, Verweise, Bilder und Tabellen. Beides zeigt Quelltext und formatierten Text zusammen. Öffnen Sie sein Menü, um Übereinander oder Geteilt zu wählen. Neue Projekte öffnen sich in Code, und jedes Projekt merkt sich den Modus, in dem Sie es verlassen haben.

Unterstreichen, Hervorheben, Hochstellen und Tiefstellen sind Pandoc-Formatierungssteuerungen im Code-Modus. Ihre Schaltflächen sind im Visuell-Modus verborgen. Verwenden Sie Code, wenn Sie mit Metadaten, Zitationssyntax oder anderen Quelltext-Konstrukten arbeiten.

Beispielquelltext herunterladen

Jedes Werkzeug der Werkzeugleiste

Wählen Sie Text aus, bevor Sie auf eine Formatierungssteuerung klicken. Im Code-Modus umschließen die meisten Werkzeuge die Auswahl oder fügen einen Platzhalter ein. Öffnen Sie Weitere Formatierungsoptionen (…), um Steuerungen zu erreichen, die nicht mehr in die Leiste passen.

Code / Visuell

Wechseln Sie zwischen Code, Visuell und Beides. Das Dokument bleibt in jedem Modus Markdown-Quelltext.

Rückgängig

Macht die letzte Änderung rückgängig. ⌘Z / Ctrl+Z.

Wiederholen

Stellt eine rückgängig gemachte Änderung wieder her. ⌘Shift+Z / Ctrl+Shift+Z.

Überschrift → Titel

Wählen Sie im Überschriftenmenü Titel, um # Title einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Überschrift → Abschnitt

Wählen Sie im Überschriftenmenü Abschnitt, um ## Section einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Überschrift → Unterabschnitt

Wählen Sie im Überschriftenmenü Unterabschnitt, um ### Subsection einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Überschrift → Unterunterabschnitt

Wählen Sie im Überschriftenmenü Unterunterabschnitt, um #### Subsubsection einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Überschrift → Kleine Überschrift

Wählen Sie im Überschriftenmenü Kleine Überschrift, um ##### Minor heading einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Überschrift → Absatzüberschrift

Wählen Sie im Überschriftenmenü Absatzüberschrift, um ###### Paragraph heading einzufügen. Ersetzen Sie den Überschriftentext durch Ihren eigenen Titel.

Aufzählungsliste

Beginnt eine unsortierte Liste. - Item.

Nummerierte Liste

Beginnt eine Abfolge. 1. Item.

Aufgabenliste

Fügen Sie im Code-Modus eine Aufgabe hinzu und ändern Sie [ ] in [x], wenn sie erledigt ist. - [ ] Task.

Zitatblock

Setzen Sie ein Zitat in eine eigene Zeile. > quoted text.

Fett

Hebt ausgewählten Text hervor. **text**; ⌘B / Ctrl+B.

Kursiv

Hebt einen Begriff hervor. *text*; ⌘I / Ctrl+I.

Durchgestrichen

Markiert Text als überholt. ~~text~~.

Code im Text

Formatiert einen Dateinamen, Befehl oder Bezeichner. Text in Backticks eingeschlossen.

Unterstrichen

Wählen Sie im Code-Modus eine Wendung aus. [text]{.underline}.

Hervorheben

Wählen Sie im Code-Modus eine Wendung aus. [text]{.mark}.

Hochgestellt

Wählen Sie im Code-Modus den Exponenten aus. ^text^.

Tiefgestellt

Wählen Sie im Code-Modus den Index aus. ~text~.

Unterstreichen und Hervorheben verwenden Pandoc-Attribute, damit die Formatierung ins PDF übernommen werden kann. Verwenden Sie diese Steuerungen, statt rohe HTML-Tags ins Manuskript einzufügen.

Verweis einfügen

Im Modus Code: Fügt [link text](url) ein. Ersetzen Sie beide Platzhalter.

Im Modus Visuell: Öffnet URL des Verweises. Geben Sie die Adresse ein und wenden Sie sie auf Ihre Auswahl an. Verwenden Sie Verweis entfernen, um den Text ohne den Verweis zu behalten.

Bild einfügen

Im Modus Code: Fügt ![caption](image-filename) ein. Ersetzen Sie Pfad und Beschriftung.

Im Modus Visuell: Öffnet Bilddatei. Geben Sie einen Projektpfad wie figures/plot.png ein und wenden Sie ihn an.

Tabelle einfügen

Im Modus Code: Fügt drei Spalten, eine Kopfzeile und zwei Datenzeilen ein. Ersetzen Sie die Spaltennamen und Zellen.

Im Modus Visuell: Fügt eine bearbeitbare Tabelle mit denselben Anfangsabmessungen ein.

Diagramm zeichnen

Öffnet den Diagramm-Editor im Mermaid-Modus. Zeichnen Sie ein Flussdiagramm auf der Zeichenfläche oder bearbeiten Sie den Mermaid-Code und wählen Sie dann Als Mermaid einfügen, um es an der Cursorposition als abgegrenzten mermaid-Codeblock hinzuzufügen. Siehe Mermaid-Diagramme.

Einblicke ins Dokument

Listet die Überschriften, Abbildungen, Tabellen, Formeln, Labels, Zitationen und To-dos des Dokuments in Quelltext-Reihenfolge auf, jedes mit seiner Zeile verknüpft. Es liest außerdem Titel, Autoren, Schlüsselwörter, Datum und Abstract aus dem Frontmatter und kann sie für ein Einreichungsformular kopieren. Siehe Einblicke ins Dokument.

Dokumenteinstellungen

Ändert Dokumentklasse, Seitengröße, Spalten, Ränder, Fließtext-Schrift, Schriftgröße, Sprache, Zeilenabstand und Abschnittsnummerierung. Oleafly schreibt Ihre Auswahl in das YAML-Frontmatter, das Pandoc liest, und fügt einen Frontmatter-Block hinzu, wenn die Datei keinen hat. Siehe Dokumenteinstellungen.

Projektinfo

Im Modus Code: Zeigt Projektstatistiken und Informationen zur Auswahl.

Im Modus Visuell: Zeigt Statistiken für die visuelle Bearbeitungsfläche.

Suchen

Im Modus Code: Öffnet die Suche der aktiven Datei mit ⌘F / Ctrl+F.

Im Modus Visuell: Die Schaltfläche „Suchen“ der Quelltext-Leiste ist verborgen.

Importieren Sie das Bild über den Dateibaum, bevor Sie darauf verweisen. Halten Sie Bildpfade relativ zum Manuskript, damit das Quelltext-Archiv auf einem anderen Rechner funktioniert.

Formeln und Codeblöcke

Schreiben Sie Inline-Mathematik als $x^2$. Setzen Sie eine abgesetzte Formel zwischen zwei Paare Dollarzeichen:

$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$

Für ein Codebeispiel schließen Sie den Code in dreifache Backticks ein und setzen seine Sprache hinter den öffnenden Begrenzer. Dies sind Quelltext-Konstrukte; die Markdown-Werkzeugleiste hat keine eigene Schaltfläche für Formeln oder abgegrenzte Codeblöcke.

Mermaid-Diagramme

Wählen Sie Diagramm zeichnen in der Werkzeugleiste, um im Diagramm-Editor ein Mermaid-Flussdiagramm zu erstellen. Als Mermaid einfügen fügt es als abgegrenzten Codeblock hinzu:

```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```

Im Modus Beides zeichnet die formatierte Seite den Block als Diagramm. Ein PDF braucht ein Bild, daher speichert der Diagramm-Editor außerdem ein gerendertes PNG unter figures/mermaid-<hash>.png, und das Kompilieren setzt dieses Bild an die Stelle des Blocks. Das Diagramm erscheint so auch im kompilierten PDF. Wenn Sie den Block danach von Hand bearbeiten, zeigt das PDF den Code, bis Sie das Diagramm wieder aus dem Diagramm-Editor einfügen oder speichern. Siehe Mermaid in Markdown-Dokumenten.

Zitationen und Literaturverzeichnis

Importieren oder erstellen Sie references.bib, fügen Sie bibliography: references.bib zu den YAML-Metadaten hinzu und zitieren Sie einen vorhandenen Schlüssel mit [@citation-key]. Pandoc verwendet die Bibliografie, um formatierte Zitationen und ein Literaturverzeichnis zu erzeugen.

Referenzen finden und verwalten →

Import und Export

Um einen bestehenden Entwurf in Markdown zu behalten, erstellen Sie ein leeres Markdown-Dokument, fügen Sie den Entwurf in main.md ein und importieren Sie seine Bilder und Bibliografie. Der separate Import Markdown-Dokument der Bibliothek wandelt einen Entwurf derzeit nach LaTeX um. Importwege erklärt beide Pfade.

Kompilieren Sie für ein PDF oder verwenden Sie Exportieren, um Word, HTML, Typst, LaTeX oder reinen Text zu erzeugen. Verwenden Sie ein Quelltext-ZIP, um das ursprüngliche Markdown und seine Assets zu teilen. Ihre Arbeit exportieren behandelt die Reihenfolge und die Prüfungen, die Sie in der konvertierten Datei vornehmen sollten.