Discord Formatting

docs/discord-formatting.md

@@ -1,6 +1,81 @@
 # Discord Formatting
 
----
+Discord also offers various formatting options to enhance your messages. These tools allow you to structure text, highlight important information, and improve overall readability. Here's an overview of the most commonly used formatting styles and how you can use them effectively in your messages.
 
-<center><h1>Coming soon</h1></center>
-<center>We're still working on adding this documentation file - please check back later or raise a PR.</center>
+## Text Formatting
+
+These formatting options represent different styles for messages that you can use in Discord to improve readability and structure. Discord message formatting allows you to emphasize important information, highlight key points, and organize text more effectively. By using these basic message styles, you can make your messages easier to understand, more visually appealing, and more engaging for other users. The following section provides an overview of the most commonly used formatting styles available in Discord.
+
+| Style | Syntax | Result |
+| :--- | :--- | :--- |
+| **Italic** | `*Text*` or `_Text_` | *Text* |
+| **Bold** | `**Text**` | **Text** |
+| **Bold Italic** | `***Text***` | ***Text*** |
+| **Underline** | `__Text__` | T͟e͟x͟t | 
+| **Strikethrough** | `~~Text~~` | ~~Text~~ |
+| **Spoiler** | See screenshot | See screenshot |
+
+![A screenshot showing spoiler, small text and all the styles at the top](@site/docs/assets/discord-formatting/en/types.png)
+
+## Headings & Structure
+With these formatting options, you can change the size of the text, making it easier to structure and organize your messages. Adjusting text size helps highlight important information, improve readability, and create clear visual hierarchies within your messages.
+
+Important: There must be a space after the `#` or `-#` characters for the formatting to work correctly.
+
+```
+# Heading 1 (Large)
+## Heading 2 (Medium)
+### Heading 3 (Small)
+-# Small Text
+```
+
+![A screenshot showing examples of headings](@site/docs/assets/discord-formatting/en/headings.png)
+
+## Lists & Quotes
+With these formatting options, you can structure your text using lists or quotes, making your messages clearer and easier to read. Lists help organize information into concise points, while quotes are useful for highlighting references, replies, or important statements. There are many different ways to create lists and quote text, allowing you to format your messages in a clear and well-structured manner.
+
+* **Bullet lists:**  
+  - `- Item 1`  
+  * `* Item 2`
+* **Numbered lists:**  
+  - `1. First item`
+  - `2. Second item`
+* **Quotes:**  
+  - `> Single-line quote`
+  - ```
+    >>> Multi-line quote
+    Ah yes multiple lines
+    ```
+
+![A screenshot showing examples of bullet lists, numbered lists, and quotes](@site/docs/assets/discord-formatting/en/types1.png)
+
+
+## Links & Code
+With these formatting options, you can change the behavior and appearance of a message. They allow you to control how a message looks and how it is perceived, helping you emphasize actions, highlight important content, and improve overall readability.
+
+* **Masked links:** `[Google](https://www.google.com)`
+* **Inline code:** `` `command` ``
+* **Code block:**  
+  ```
+  ```js
+  console.log("Code block")
+  ```‎
+  ```
+
+When using code blocks, it is possible to specify the programming language used for syntax highlighting. In this code block, we use JavaScript (hence the `js` in the first line). You can also specify other programming languages by simply replacing `js` with the desired language (e.g. `py` for Python, `html` for HyperText Markup Language, etc.).
+
+![A screenshot showing examples of masked links, inline code, and code blocks](@site/docs/assets/discord-formatting/en/types2.png)
+
+## Timestamps
+Dynamic timestamps in Discord allow you to display times and dates that automatically adapt to the user’s time zone, making messages more informative and context-aware. These timestamps are especially useful for events, deadlines, reminders, or any message where the timing needs to be clear for users across different regions. By using dynamic timestamps, you can improve clarity and engagement in your Discord server.
+
+Timestamps use **UNIX time**, which is a system that counts the number of seconds that have elapsed since **January 1, 1970 at 00:00:00 UTC** (also known as the Unix epoch). UNIX time is widely used in programming, databases, APIs, and server logs because it provides a simple, consistent, and timezone-independent way to represent points in time.
+
+### Examples of Discord Timestamp Formatting:
+* `<t:1737835851:t>` → Time (short format)
+* `<t:1737835851:D>` → Date (long format)
+* `<t:1737835851:R>` → Relative time (e.g., “5 minutes ago”)
+
+You can customize and generate timestamps exactly how you want using the [Discord Timestamp Generator](https://scnx.app/user/tools?page=timestamp-generator).
+
+![A screenshot showing examples of different timestamp formats](@site/docs/assets/discord-formatting/en/types3.png)

i18n/de/docusaurus-plugin-content-docs/current/discord-formatting.md

@@ -0,0 +1,80 @@
+# Discord Formatierung
+
+Discord bietet außerdem verschiedene Formatierungsoptionen, um deine Nachrichten übersichtlicher und ansprechender zu gestalten. Mit diesen Funktionen kannst du Texte strukturieren, wichtige Informationen hervorheben und die Lesbarkeit insgesamt verbessern. Hier ist eine Übersicht der am häufigsten verwendeten Formatierungsstile und wie du sie effektiv einsetzen kannst.
+
+## Textformatierung
+Diese Formatierungsoptionen stellen verschiedene Stile für Nachrichten dar, die du in Discord verwenden kannst, um die Lesbarkeit und Struktur deiner Texte zu verbessern. Mit der Discord-Nachrichtenformatierung lassen sich wichtige Informationen hervorheben, Inhalte übersichtlich gliedern und Nachrichten optisch ansprechender gestalten. Durch die Nutzung dieser grundlegenden Nachrichtenstile werden Texte klarer, verständlicher und insgesamt angenehmer für andere Nutzer zu lesen. Im folgenden Abschnitt findest du eine Übersicht der am häufigsten verwendeten Formatierungsstile in Discord.
+
+| Stil | Syntax | Ergebnis |
+| :--- | :--- | :--- |
+| **Kursiv** | `*Text*` oder `_Text_` | *Text* |
+| **Fett** | `**Text**` | **Text** |
+| **Fett & kursiv** | `***Text***` | ***Text*** |
+| **Unterstrichen** | `__Text__` | T͟e͟x͟t | 
+| **Durchgestrichen** | `~~Text~~` | ~~Text~~ |
+| **Spoiler** | Siehe Screenshot | Siehe Screenshot |
+
+![Ein Screenshot, der Spoiler, kleinen Text und alle Stile oben zeigt](@site/docs/assets/discord-formatting/de/types.png)
+
+## Überschriften & Struktur
+Mit diesen Formatierungsoptionen kannst du die Größe des Textes ändern, wodurch sich deine Nachrichten besser strukturieren und übersichtlicher gestalten lassen. Unterschiedliche Textgrößen helfen dabei, wichtige Informationen hervorzuheben, die Lesbarkeit zu verbessern und eine klare visuelle Hierarchie innerhalb einer Nachricht zu schaffen.
+
+Wichtig: Nach den Zeichen `#` oder `-#` muss immer ein Leerzeichen folgen, damit die Formatierung korrekt funktioniert.
+
+```
+# Überschrift 1 (Groß)
+## Überschrift 2 (Mittel)
+### Überschrift 3 (Klein)
+-# Kleiner Text
+```
+
+![Ein Screenshot mit Beispielen für Überschriften](@site/docs/assets/discord-formatting/de/headings.png)
+
+## Listen & Zitate
+Mit diesen Formatierungsoptionen kannst du deinen Text mithilfe von Listen oder Zitaten strukturieren, wodurch Nachrichten übersichtlicher und leichter verständlich werden. Listen eignen sich ideal, um Informationen klar zu gliedern, während Zitate verwendet werden können, um Aussagen hervorzuheben, auf andere Nachrichten zu reagieren oder Inhalte zu referenzieren. Es gibt viele verschiedene Möglichkeiten, Texte als Liste oder Zitat darzustellen, sodass du deine Nachrichten flexibel und strukturiert formatieren kannst.
+
+* **Aufzählungen:**  
+	- `- Punkt 1`  
+	* `* Punkt 2`
+* **Nummerierte Listen:**  
+	- `1. Erster Punkt`
+    - `2. Zweiter Punkt`
+* **Zitate:**  
+	- `> Einzeiliges Zitat`
+	- ```
+	  >>> Mehrzeiliges Zitat
+	  Mehr Zeilen
+	  ```
+
+![Ein Screenshot mit Beispielen für Aufzählungen, nummerierte Listen und Zitate](@site/docs/assets/discord-formatting/de/types1.png)
+
+
+## Links & Code
+Mit diesen Formatierungsoptionen kannst du das Verhalten und das Erscheinungsbild einer Nachricht verändern. Sie ermöglichen es, hervorzuheben, wie eine Nachricht aussieht und wahrgenommen wird, um Aktionen zu betonen, wichtige Inhalte hervorzuheben und die allgemeine Lesbarkeit zu verbessern.
+
+* **Maskierte Links:** `[Google](https://www.google.com)`
+* **Inline-Code:** `` `Befehl` ``
+* **Codeblock:**  
+	```
+	```js
+    console.log("Mehrzeiliger Code oder Text")
+	```‎
+	```
+
+Beim Verwenden von Codeblöcken ist es möglich, die verwendete Programmiersprache für die Syntaxhervorhebung anzugeben. In diesem Codeblock verwenden wir JavaScript (daher das `js` in der ersten Zeile). Du kannst auch andere Programmiersprachen angeben: Ersetze dazu einfach `js` durch die gewünschte Sprache (z. B. `py` für Python, `html` für die Hypertext Markup Sprache usw.).
+
+![Ein Screenshot mit Beispielen für maskierte Links, Inline-Code und Codeblöcke](@site/docs/assets/discord-formatting/de/types2.png)
+
+## Timestamps
+Dynamische Timestamps in Discord ermöglichen es, Zeiten und Daten anzuzeigen, die sich automatisch an die Zeitzone des Nutzers anpassen. So werden Nachrichten für alle Beteiligten verständlicher und kontextbezogener. Diese Timestamps sind besonders nützlich für Events, Deadlines, Erinnerungen oder jede Nachricht, bei der die genaue Zeit für Nutzer in verschiedenen Regionen klar sein muss. Durch die Verwendung dynamischer Timestamps wird die Übersichtlichkeit erhöht und die Interaktion auf deinem Discord-Server verbessert.
+
+Timestamps verwenden die **UNIX-Zeit**, ein System, das die Anzahl der Sekunden seit dem **1. Januar 1970 um 00:00:00 UTC** (bekannt als Unix-Epoche) zählt. UNIX-Zeit wird häufig in der Programmierung, in Datenbanken, APIs und Server-Logs verwendet, da sie eine einfache, konsistente und zeitzonenunabhängige Möglichkeit bietet, Zeitpunkte darzustellen.
+
+### Beispiele für Discord-Timestamp-Formate:
+* `<t:1737835851:t>` → Zeit (kurzes Format)  
+* `<t:1737835851:D>` → Datum (langes Format)  
+* `<t:1737835851:R>` → Relative Zeit (z. B. „vor 5 Minuten“)
+
+Du kannst Timestamps genau nach deinen Wünschen erstellen und anpassen mit dem [Discord Timestamp Generator](https://scnx.app/user/tools?page=timestamp-generator).
+
+![Ein Screenshot, der verschiedene Beispiele für Timestamps zeigt](@site/docs/assets/discord-formatting/de/types3.png)