Lessons — barakgahtan.github.io
Lessons — barakgahtan.github.io
Seeded 2026-07-10. Append a dated lesson after any correction (global CLAUDE.md §1.3) so the mistake never repeats.
2026-09-04 — kramdown turns pipe characters into tables
A markdown line containing ` | ` (e.g. **Role | Company (dates)**) is parsed by kramdown as a table row, which breaks all inline formatting on that line (literal ** shows on the live site). Use ` · ` or a comma as the separator in headings/list items, never a bare pipe. Verify rendering on the live page after deploy (curl | grep '<table'), since there is no local Jekyll install.
