Một lượt chạy của mẫu nghiên cứu đa nguồn đã tạo ra một báo cáo tốt về các công cụ đầu tư, rồi in nó ra một cách tệ hại. Chín mươi lăm ký hiệu dạng [^1] nằm ngay trong văn bản, và chín dòng dạng [^1]: chất chồng bên dưới. Cả trên web lẫn trên điện thoại.
Nguyên nhân là chú thích cuối trang không phải một phần của Markdown. Đó là một phần mở rộng, và không có cỗ máy Markdown nào trong hai cỗ máy chúng tôi phân phối — một cho web, một cho di động — triển khai nó. Chúng tôi đã yêu cầu mô hình đúng định dạng này, rồi hiển thị nó như văn bản nguyên văn.
Một bộ viết lại, hai cỗ máy
Thay vì dạy cùng một phần mở rộng cho cả hai bộ hiển thị, các ký hiệu được viết lại trước khi bất kỳ bộ nào nhìn thấy chúng, thành một liên kết đơn giản mà cả hai đã hiển thị giống hệt nhau. Các định nghĩa được tách ra và trả về riêng, còn phần theo sau chúng vẫn giữ lại như phần cuối tài liệu. Dấu ngoặc vuông vẫn nằm trong văn bản liên kết, nên các trích dẫn chồng lên nhau đọc thành [1][2], không phải 12.
Trên web, trích dẫn được vẽ dưới dạng chỉ số trên, các định nghĩa được hiển thị dưới dạng danh sách với các điểm neo thực sự, nhấp vào một trong số đó sẽ cuộn đến nó và làm nhấp nháy dòng đó, còn con số trong danh sách nhảy về nơi nó được trích dẫn lần đầu. Di chuột qua sẽ hiện định nghĩa mà không di chuyển. Trên điện thoại, cùng các ký hiệu đó được vẽ bằng màu nhấn, và chạm vào một trong số đó sẽ cuộn bảng đến dòng tương ứng. Các liên kết không phải trích dẫn vẫn mở trong trình duyệt như trước.
Các thẻ nguồn bên dưới báo cáo chưa bao giờ bị ảnh hưởng — chúng đến từ nơi khác và luôn ổn.
Và trong bản tải xuống
Một báo cáo bạn tải xuống dưới dạng .docx, .pdf hay .md đi qua một bộ chuyển đổi khác, in các ký hiệu thô trực tiếp vào tài liệu. Một đặc tả tài liệu không có chỉ số trên, nên một trích dẫn được in thành [3], và mỗi định nghĩa mở ra dòng riêng của nó bắt đầu bằng [3]. Các dòng tiếp nối có thụt lề gắn vào định nghĩa của chúng. Các con số trong tệp chính là các con số trên màn hình.
Nỗ lực đầu tiên đã sai theo cách chúng tôi vốn đã có biện pháp bảo vệ
Phiên bản đầu tiên biến các số chú thích cuối trang thành liên kết đoạn thông thường — href="#fn-3". Dưới <base href="/"> mà một ứng dụng một trang cần đến, một đoạn trần trụi được giải quyết dựa trên gốc của trang web, vì vậy liên kết trỏ đến trang chủ. Bộ xử lý cú nhấp đã hủy việc điều hướng, nên nó vẫn hoạt động — và sẽ tiếp tục hoạt động cho đến khi ai đó chạm vào bộ xử lý đó.
Một kiểm tra chúng tôi đã có đúng cho mẫu hình này chuyển sang màu đỏ trong lần chạy cục bộ trước khi đẩy mã. Các con số giờ đây là các nút; chúng cuộn, di chuyển tiêu điểm, và tôn trọng tùy chọn giảm chuyển động của người đọc.