Quartz

Whatis

Quartz — static site generator, который собрал этот сайт.

Pros & cons

Ощущается как плохо написанный инструмент, но генерирует красивые странички.
mkdocs (material) написан лучше, с ним приятнее работать, но страницы на выходе хуже, чем у quartz.
Thats all.

Troubleshoot

Word higlighting is not working with asterisk symbol

В конструкции / / Asterisk symbol (*) не работает, даже если экранировать (\):

```go /*p/ /\*p/
...
*p *= *p
...
```

При чем явную ошибку в выводе ты не получишь даже с --verbose в команде:

npx quartz build --serve --verbose

Всё, что ты получишь — зависшую сборку на этапе [process]. При чем, проблемного файла в выводе не будет, ибо он даже не process-ится, как я понимаю.
Допустим, проблемный файл — это go/go-pointers.md, значит вывод зависнет до его proccessing-а и в выводе его не будет:

...
[process] content/go/go-imports.md -> go/go-imports (13ms)
[process] content/go/go-packages.md -> go/go-packages (10ms)

<сборка зависла>