Guide
QR helpers
Use comark-etiket QR helper directives to build WiFi, email, SMS, geo, vCard, and structured QR payloads from attrs.
QR helper directives build the encoded payload from attrs. You do not write the raw QR string yourself.
Pick a helper directive
| Directive | Required attrs | Example |
|---|---|---|
::qr-wifi | ssid, password | ::qr-wifi{ssid="Net" password="pass"} |
::qr-email | address | ::qr-email{address="hi@example.com"} |
::qr-sms | phone | ::qr-sms{phone="+1234567890" message="Hello"} |
::qr-geo | lat, lng | ::qr-geo{lat="48.8584" lng="2.2945"} |
::qr-url | url | ::qr-url{url="https://example.com"} |
::qr-phone | phone | ::qr-phone{phone="+1234567890"} |
::qr-vcard | contact fields | ::qr-vcard{first-name="Ada" last-name="Lovelace" email="ada@example.com"} |
::qr-mecard | contact fields | ::qr-mecard{name="Ada Lovelace" phone="+1234567890"} |
::qr-event | title, start, end | ::qr-event{title="Meeting" start="20250101T090000Z" end="20250101T100000Z"} |
::swiss-qr | structured fields | see Swiss QR Bill |
::gs1-digital-link | structured fields | see GS1 Digital Link |
Configure WiFi QR codes
qr-wifi.md
::qr-wifi{ssid="GuestNetwork" password="Welcome123"}
::
Configure contact QR codes
qr-vcard.md
::qr-vcard{first-name="Ada" last-name="Lovelace" email="ada@example.com"}
::
Use structured Swiss QR and GS1 Digital Link
::swiss-qr and ::gs1-digital-link accept nested fields via JSON attrs or YAML block props. See the etiket docs for field schemas.