Willkommen im Mahlzahn-Magazin

Mahlzahn ist inzwischen mehr als eine Entity-Exploration. Hier findest du, was in der Redaktion an Artikeln, Setups und Learnings zusammenkommt — redaktionell und bewusst entspannt.

Das Magazin ist der neue Bereich neben Constellations, Apps, Modellen und Erweiterungen. Der Unterschied: Artikel hier kommen nicht aus der Datenbank. Sie sind von Menschen geschrieben, mit Bildern, Videos und Code-Beispielen — und sie lesen sich hoffentlich angenehmer als eine Tabelle.

Was dich erwartet

• Erste-Schritte-Artikel zu Modellen, Apps und Constellations.
• Entscheidungs-Geschichten — warum wir Tool X nehmen, Tool Y sein lassen.
• Ehrliche Post-Mortems aus echten Stacks im Alltag.
• Gelegentlich ein Meinungsstück, wenn es etwas klarzustellen gibt.

Warum alle Artikel gleich aussehen

Das ist kein Zufall. Jeder Autor und jede Autorin schreibt in HTML — aber nur mit einem festen Satz an Klassen. Dadurch sehen Code-Blöcke, Callouts, Screenshots und Schritte überall identisch aus, egal wer den Artikel geschrieben hat.

Fürs nächste Mal

Neue Artikel landen in content/magazin/, der mahlzahn-magazin-Skill begleitet beim Schreiben, und npm run check:magazin prüft die Einhaltung.

So sieht ein Code-Block im Magazin aus:

      

        lib/magazin/loader.ts · typescript
      
import matter from "gray-matter";
import { ArticleFrontmatter } from "./frontmatter-schema";

export async function loadArticle(slug: string) {
  const source = await fs.readFile(file, "utf8");
  const parsed = matter(source);
  const result = ArticleFrontmatter.safeParse(parsed.data);
  if (!result.success) throw new Error("Ungültiges Frontmatter");
  return { frontmatter: result.data, body: parsed.content };
}

Und das sind Schritte, wenn du selbst einen Artikel beisteuern willst:

1. 1
   Datei anlegen

   Name nach dem Schema YYYY-MM-DD-slug.html in content/magazin/.

2. 2
   Frontmatter ausfüllen

   Titel, Slug, Datum, Autor-Slug (muss in public.person existieren), Tags, Cover-Pfad, Accent-Farbe, Excerpt.

3. 3
   Schreiben

   Nur Klassen aus dem Katalog nutzen. Der Skill liefert Copy-Paste-Snippets für Callouts, Figures, Steps, Code-Blöcke.

4. 4
   Prüfen

   npm run check:magazin läuft den Regelwerks-Check. Wenn er grün ist, darf der Artikel live.

Was als nächstes kommt

• Artikel über konkrete Constellations, die sich im Alltag bewährt haben.
• Retrospektiven, wenn etwas nicht funktioniert hat — und was wir daraus gelernt haben.
• Kleine Tool-Porträts: was eine neue App kann, was sie nicht kann, wann sie sich lohnt.

Also: Schau gern öfter rein. Wer selbst etwas beitragen möchte, meldet sich einfach in der Redaktion.