gstrainovic/zid / .claude/skills/markdown-preview
markdown-preview
VerifiedMarkdown-Vorschau in zid: Tabellen, Umbruchbreite, Word Wrap, Balken, Textauswahl, Suche (Ctrl+F), Schriftgröße, abfragbare IDs für E2E. Use when touching src/ui/markdown_view.zig, md_select.zig, md_find.zig, word_wrap.zig, reloadMarkdownPreview, preview rendering or scrolling, zigdown styling limits (strikethrough, bold/italic), or scripts/e2e_md_preview*.py, e2e_find_preview.py.
Markdown-Vorschau
-
Tabellen in der Vorschau: zigdown liefert eine Tabelle als Container mit flacher Zellliste (je
ncolParagraphen eine Zeile, erste Zeile = Kopf).MarkdownView.renderTablebaut daraus das Raster. Die Spaltenbreiten kommen wie im Browser aus dem Inhalt:measureCellliefert je Zelle die Wunschbreite (eine Zeile) und die Mindestbreite (breitestes unteilbares Stück), die Tabelle verteilt proportional und staucht notfalls die jeweils breiteste Spalte.relative_widthaus der Trennzeile bleibt ungenutzt, die Zahl der Striche sagt nichts über den Inhalt. Die Tabelle steht in zweigrow-Hüllen (md_table_rowmit Frame-Nummer für die E2E, darinmd_table_boxmit je Block stabiler Nummer zum Messen) und ist selbstfit— gemessen wird die Hülle, sonst schrumpft die Tabelle Frame für Frame an ihrer eigenen Breite. Die Hüllenbreite ist nach oben durchwrap_width_hintgedeckelt:growwird nie schmaler als das Kind und hielte sonst eine Überbreite aus dem ersten Frame (noch ohne Hint, 800 px) für immer fest. Keinclipje Zelle: Clay hält nur zehn Clip-Container, eine Tabelle sprengt das sofort („out of bounds array access"). Zu lange Wörter zerlegt stattdessensplitWide; Fließtext und Tabellen scrollen nie waagrecht, nur Codeblöcke (siehe unten). Fixture:libs/zigdown/test/table.md, geprüft inscripts/e2e_md_preview.py. Spaltenausrichtung (alignment) wird nicht umgesetzt. -
Listenzeichen:
renderBlocksetzt vor jeden Eintragmd_bullet: „•“ beiunordered, „N.“ abList.startbeiordered, beitask(- [ ]/- [x], Klammern nimmt zigdown aus dem Text) ein Lucide-Kästchen (square/square_check, angehakt in Akzentfarbe) mit der IDmd_check_<n>, n wie beimd_li. Die Breite des Zeichens geht inindentein. Geprüft ine2e_md_preview.check_taskanlibs/zigdown/test/spaced-list.md. -
Abfragbare IDs der Vorschau (E2E):
md_tcellmit Index Tabelle × 100000 + Zeile × ncol- Spalte (Tabellen ab 1),
md_quote,md_li/md_bulletundmd_codemit laufender Nummer ab 1. Alle Zähler setztresetCounterszu Beginn jedes Frames zurück. IDs, an denen die Vorschau im nächsten Frame eine Breite abliest (md_run_…influshPieces,md_table_box), tragen dagegen den Block-Index und einen je Block gezählten Lauf (beginBlocksetzt zurück): frameweite Nummern verrutschen, sobald das virtualisierte Fenster oben einen Block verliert, und die Vorschau zappelt beim Rad-Scrollen. Zweite Ursache für Springen: Blöcke im Vorlauf über der Oberkante wechseln von Schätzung auf Messung,syncBlockHeightsgleicht das überscrollbar.anchorShiftim Offset aus.e2e_md_preview.pyprüft, dass ein Rad-Schritt sichtbare Blöcke um genau 60 px bewegt.e2e_md_preview.pyöffnet jedelibs/zigdown/test/*.md(Glob), legt je Dateitmp/e2e_md_example_<name>.ppmab und prüft Zitatrand, Aufzählungszeichen und Codeblock-Hintergrund an Pixeln des Screenshots.
- Spalte (Tabellen ab 1),
-
Umbruchbreite = Hint minus Einrückung, plus Clays Viertelpixel.
MarkdownView.indentsummiert die Einrückungen um den gezeichneten Block (Liste 24 px plus Punkt und Abstand, Zitat 16 px, Alert 32 px);availWidthzieht sie vomwrap_width_hintab, undflushPieces,renderTable,renderCodeBlockbrechen daran um; sonst ragt Text in Listen um die Einrückung über den Rand und wird stumm abgeschnitten. Zweiter Anteil: Clay schlägt je Textelement 0.25 px auf (measureTextin mod.zig), jedes Wort ist ein eigenes Element —flushPiecesrechnet den Zuschlag wiemeasureCellmit, sonst ist eine Zeile aus 40 Wörtern 10 px zu breit. Symptom für beides:md_contentbreiter alsmd_viewportohne breiten Code. Bei Verdacht die Datei in Zeilenbereiche schneiden und je Scheibe headless die Breite messen (Probe im Stil vone2e_md_preview.step_wide_code), statt am Fenster zu raten. -
Balken der Vorschau kommen beide aus
scrollbar.zig(vModel/hModel, Pixel als Einheiten,md_scrollbar_*/md_hscroll_*): Klick blättert, Thumb zieht (vdrag/hdrag),rendermeldet Hover →scrollbar_hovered, undUI.getDesiredCursorfragt zuerstMarkdownView.cursorAt(Pfeil über Balken und Menü, I-Beam übermd_viewport). Keine zweite Balken-Implementierung anlegen, alle Balken laufen überscrollbar.zig.ui_state.cursor(E2E) liefert die Cursorform an der Mausposition;e2e_editor.step_hscrollbar,e2e_md_preview.step_wide_code,e2e_explorer.step_scrollbarunde2e_terminal.pyprüfen Pfeil über Balken (Editor und Vorschau auch I-Beam über Text) — bei jedem neuen Balken den Test ergänzen. Explorer und Terminal werten den Hover nicht aus (dort gilt ohnehin der Pfeil); nur das Ziehen des Explorer-Thumbs hält den Pfeil auch über dem Editor. Zeilen unter einem Balken bekommen keinen Klick: Clay-Floating-Elemente fangen den Zeiger (capture). -
Word Wrap in der Vorschau: Alt+Z, ein Schalter für Editor und Vorschau — bewusst anders als VS Code. VS Code bricht in der Vorschau Fließtext immer um, Code nie (
pre { overflow: auto }), undeditor.wordWrapwirkt dort nicht. Der Projektinhaber will stattdessen den Editor-Schalter, und zwar sichtbar am Fließtext, nicht nur an Code.renderliestgetActiveEditor().word_wrapinMarkdownView.wrap. Ein:flushPiecesbricht mitsplitWide/wrapLinesanavailWidth,renderCodeBlockbricht Codezeilen mitcodeRowEndan jeder Stelle in Reihen (Join.none, kopiert ohne Trenner). Aus:flushPiecesgibt jedem Lauf eine Reihe (LimitfloatMax), Codezeilen laufen hinaus,md_contentwächst mit der längsten Zeile (growwird nie schmaler als das Kind),md_viewportverschiebt perchild_offset.x, unten liegt der waagrechte Balken ausscrollbar.zig(md_hscroll_track/_thumb; Klick blättert, Thumb zieht, Shift+Rad bzw. Touchpad überUI.handleScrollHorizontal→scrollColumns, 60 px je Schritt). Tabellen passen in beiden Fällen in die Breite. Es scrollt der ganze Inhalt, nicht nur der Block: ein Clip je Block geht nicht, der Renderer schneidet verschachtelte Clips nicht (Skillclay-layout) und Clay hält nur zehn. Der Nutzerzustand (~/.config/zid/state,word_wrap=) gilt beim Start auch für die Vorschau. E2Estep_wide_code: aus → breit mit Balken, ein → Listen, Zitat und 400-Zeichen- Code passen; Screenshotse2e_md_preview_{list_wrapped,wrapped,wide,wide_scrolled}.ppm. -
Umbruch nur an Leerzeichen:
word_wrap.wrapLinestrennt zwischen Wörtern, nie zwischen zwei Stücken ohne Leerzeichen dazwischen — zigdown liefertcode, Satzzeichen und Wortteile einzeln, „Nr." kommt als „Nr" und „.".measureCellrechnet genauso und schlägt je Textelement 0.25 px auf, den Zuschlag ausmeasureTextinmod.zig. -
Textauswahl in der Vorschau (Logik in
src/ui/md_select.zig, unit-getestet): Ziehen mit der Maus markiert wie im Browser, Ctrl+C und Kontextmenü „Copy“ kopieren, Escape oder ein Klick ohne Ziehen heben auf. Position = (Block auf oberster Ebene, Zeile im Block, Byte-Offset), damit die Auswahl gültig bleibt, während die Virtualisierung andere Blöcke zeichnet. Jede Textreihe ausflushPiecesund jede Codeblock-Zeile trägt die IDmd_line(laufend je Frame) und landet mit Text inline_texts(bleibt über Frames, damit ein herausgescrolltes Ende kopierbar ist;endBlockwirft Zeilen weg, die es nach neuem Umbruch nicht mehr gibt). Hit-Test nimmt die Clay-Box der Reihe aus dem Vorframe und misst Codepoints (offsetAtX). Hervorhebung:textSelteilt ein Stück an den Auswahlgrenzen, der markierte Teil steht in einemmd_sel-Element mit Hintergrund — kein Floating, keine Alpha-Überlagerung, Elemente nur für markierte Stücke. Kopiertext: weiche Umbrüche werden wieder Leerzeichen, harte Zeilen\n, Blockwechsel\n\n(zigdown macht aus LeerzeilenBreak-Blöcke, die bleiben stumm), Absatzenden verlieren ihr Leerzeichen-Stück; ein nie gezeichneter Block dazwischen kommt als Fließtext aus dem Baum. Ändern sich Umbruchbreite oder Schriftgröße, wird die Auswahl aufgehoben (Zeilennummern stimmen dann nicht mehr). Andere Tasten und Buchstaben erreichen den unsichtbaren Editor hinter Vorschau, Bild, PDF und Binär-Tab nicht (UI.handleKeyPress/handleCharprüfenactiveTabKind() == .text), sonst schluckt eine unsichtbare Editor-Suchleiste das Getippte. -
Suche in der Vorschau (Ctrl+F) nimmt die Bausteine des Editors, nichts nachgebaut: Zustand, Leiste und Tasten aus
src/editor/find_bar.zig(FindState,render; auch der Editor zeichnet damit), Treffer ausfind_ops.Pattern(Aa/W/.* wie im Editor, Alt+C/W/R). Nur die Vorschau-Teile stehen insrc/ui/md_find.zig(unit-getestet): Weil virtualisiert gezeichnet wird, zähltrefreshFinddie Treffer über den Klartext jedes Blocks (Hit= Block, n-tes Vorkommen),lineMarkszählt beim Zeichnen je Zeile in derselben Reihenfolge mit; so weiß die Zeile, ob sie den aktuellen Treffer trägt. Sprung: liegt der Block außerhalb des gezeichneten Fensters, erst über die Blockhöhe, dann rücktapplyFindRevealeinige Frames lang über die gezeichnete Zeile nach (senkrecht, ohne Umbruch auch waagrecht; Boxen gelten mit dem Bildlauf des Vorframes,drawn_scroll_*). Markierung intextSelübermd_find.segments(md_hit,md_hit_cur, Auswahlmd_selhat Vorrang). Grenze: ein Begriff über einen weichen Umbruch hinweg zählt im Klartext, wird in den Zeilen aber nicht gefunden. Speichern baut die Vorschau neu und übernimmt die Suche (adoptFind). RPCmd_find_state, E2Escripts/e2e_find_preview.py. RPCmd_selection(open,lines,text), E2E inscripts/e2e_md_preview.py(step_selection). Marp-Decks zeigt nichtMarkdownView, sondern das PDF aus marp-cli (Skillmarp). Chat-Bubbles: jede Nachricht hat ihre eigeneMarkdownView,AIChatState.handleMouseDowntrifft die Bubble (ai_msg_<idx>) und startet dort die Auswahl (sel_msg, untermutex, weil der Worker Nachrichten anhängt); Ctrl+C kopiert markierten Bubble-Text vor dem Eingabefeld, Escape hebt auf. Ein Klick ohne Ziehen kopiert die ganze Nachricht, und zwar beim Loslassen (pending_copy_msg, im Render, dort ist das Fenster). Die wachsende Stream-Bubble ist nicht auswählbar (wird je Token neu gebaut). RPCchat_line_bounds(msg, line); E2Eselect_in_bubbleine2e_ai_chat.py. -
Vorschau neu laden: Speichern (Ctrl+S oder Autosave) baut eine offene Vorschau derselben Datei neu auf (
UI.reloadMarkdownPreview, liest die Datei, behält Scroll-Position, Folie und Schriftgröße); Split „Editor links, Vorschau rechts“ zieht damit nach. E2E:python3 scripts/e2e_md_preview_reload.py. -
Schriftgröße der Vorschau:
UI.previewFontSize(Editor minus 4, Standard 24 → 20).setFontSizeAllsetzt sie bei jedem Zoom auf alle offenenopen_markdown_views, und beide Stellen, die eine Vorschau anlegen (src/main.zigund der Render-Zweig inmod.zig), übernehmen sie, sonst bleibt die Vorschau auf ihrer Startgröße stehen.
Bekannte Grenzen (kein Todo, bewusst so)
- Durchgestrichen:
~~text~~toggelt zigdown zweimal und bleibt ungestylt,~text~funktioniert. Upstream-Verhalten in zigdown. - Fett/Kursiv nur über Farbe: Es gibt eine einzige Font-Face (JetBrainsMono-Regular). Echte Schnitte bräuchten Font-IDs im Text-Renderer und eine zweite geladene Face. MarkdownView zeigt Styles deshalb als Theme-Farben (fett=primary, kursiv=accent, Code=warning, Link=blau, durchgestrichen=muted).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |