HN ra mắt: Markwhen, Markdown dành cho timeline

 (markwhen.com)
3 điểm bởi GN⁺ 2024-12-02 | 1 bình luận | Chia sẻ qua WhatsApp
  • Markwhen là một ngôn ngữ giống Markdown để ghi bằng văn bản thuần các nhật ký, lịch trình, ghi chú và việc cần làm diễn ra theo thời gian, rồi xem chúng như timeline hoặc lịch
  • Cú pháp hỗ trợ không chỉ ngày đơn và khoảng ngày mà còn nhiều định dạng ngày, nhóm, thẻ, checklist, liên kết, múi giờ, lịch lặp, frontmatter và thuộc tính
  • Cùng một đầu vào có thể xem dưới dạng JSON, Timeline, Calendar, Oneview, giúp chuyển qua lại giữa bản ghi con người đọc được và dữ liệu máy xử lý được
  • Đầu ra JSON bao gồm cây sự kiện, khoảng ngày ISO, thẻ, văn bản bổ trợ, phiên bản parser 1.0.1... để có thể kiểm tra trực tiếp kết quả phân tích cú pháp
  • Meridiem đi kèm là trình soạn thảo Markwhen/Markdown với các tính năng chỉnh sửa cộng tác, lệnh tùy chỉnh, snippet, trực quan hóa, tự động hoàn thành và tô sáng sự kiện

Các bản ghi theo thời gian mà Markwhen xử lý

  • Markwhen là một ngôn ngữ nhật ký giống Markdown để viết các mục theo thời gian bằng văn bản thuần
  • Hướng tới các định dạng như log, biểu đồ Gantt, blog, feed, ghi chú, nhật ký, diary, việc cần làm, timeline và lịch

  • Cú pháp đầu vào

    • Biểu diễn ngày: Có thể dùng ngày đơn, khoảng ngày và nhiều định dạng ngày như 2025-04-09: Single date, 2025-01-22 / 2026-10-24: Date range, Dec 1 2025
    • Nhóm: Gom các mục như Christmas Eve, Christmas bằng group Part one và endGroup
    • Thẻ: Gắn các thẻ như #holiday, #haloween vào sự kiện
    • Checklist: Viết việc cần làm theo từng năm ở dạng - [x], - []
    • Liên kết: Có thể đưa liên kết Google, DuckDuckGo, Bing vào các mục checklist
    • Múi giờ: Chỉ định timezone: America/New_York rồi viết thời điểm như 2025-01-01 12:00
    • Lịch lặp: Dùng các biểu thức như every year for 10 years, every 60 minutes x12
    • frontmatter và thuộc tính: Bao gồm các giá trị như title, description, leader, attendees

  • Đầu ra và kết quả phân tích cú pháp

    • Các tab đầu ra gồm JSON, Timeline, Calendar, Oneview
    • Ví dụ JSON bao gồm firstLine, properties, textRanges, dateRangeIso, tags, supplemental, matchedListItems... của sự kiện
    • Trong ví dụ JSON, parser.version được hiển thị là 1.0.1, đồng thời cũng có thông báo cảnh báo khuyến nghị chỉ định header timezone khi chưa chỉ định múi giờ

Trình soạn thảo và tài nguyên liên quan

  • Meridiem là trình soạn thảo dành cho Markwhen và Markdown
    • Hỗ trợ chỉnh sửa cộng tác, lệnh tùy chỉnh, snippet, trực quan hóa tùy chỉnh, tự động hoàn thành, tô sáng sự kiện...
    • Liên kết tải xuống được hiển thị là Download v1.0.12 2026-07-01
  • Remark.ing là cách xử lý từng mục viết bằng Markwhen như một remark giống tweet
    • Ví dụ được cung cấp là meridiem.markwhen.com/bella/recipes.raw và remark.ing/bella/recipes
    • Có liên kết yêu cầu đăng nhập bằng Meridiem để bắt đầu
  • Các tài nguyên phát triển và sử dụng cũng được cung cấp
  • Kho GitHub liệt kê landing site, trình theo dõi issue chung, Obsidian Plugin, Markwhen CLI, Timeline, Parser, VS Code Extension, View client library, Calendar, C2, Resume

Bài viết liên quan

1 bình luận

 
GN⁺ 2024-12-02
Ý kiến trên Hacker News

  • Tôi là nhà phát triển. Rất vui vì mọi người thích markwhen; tôi đã làm nó vài năm rồi, ban đầu lấy cảm hứng từ timeline cuộc đời của cheeaun được nhắc đến trong một bình luận khác.
    Hiện nó có dưới dạng tiện ích mở rộng VS Code, plugin Obsidian, công cụ CLI và trình biên tập web của Meridiem.
    Gần đây tôi đã tạo Dial, một fork của bolt.new từ Stackblitz; trong trình duyệt, bạn có thể chỉnh sửa các trực quan hóa markwhen hiện có (timeline, lịch) hoặc tự tạo trực quan hóa mới. Vừa ra mắt hôm qua nên vẫn còn thô, nhưng tôi dự định mở rộng mạnh.
    Tôi cũng đã cho phép gắn thuộc tính sự kiện dạng key: value vào từng mục, và trong tương lai muốn hỗ trợ metadata như người tham dự, Google Calendar ID, với mục tiêu tương tác được với iCal.
    remark.ing vẫn còn rất dang dở, nhưng là một trang blog hợp nhất kiểu Twitter/Bluesky/Mastodon; khi dùng markwhen thì mỗi mục trở thành một bài viết. Gắn ngày trong tương lai thì thành đặt lịch đăng, và có thể để toàn bộ blog trong một tệp.

    • Gần đây tôi đã dùng Markwhen để làm một biểu đồ Gantt tương tác cho đề xuất hợp tác, và nó hoạt động rất tốt. Cuối cùng chúng tôi đã giành được dự án đó.
      Tôi phát triển bằng plugin Obsidian, còn triển khai dưới dạng HTML tĩnh.
    • Chúc mừng ra mắt. Tôi đang làm đúng một công cụ tương tự thì nó đã ra trước; xem ra khó mà cạnh tranh với mức chức năng và độ hoàn thiện này.
    • Trông rất hay, nhưng khá khó tìm cách đăng ký.
      Ngoài ra, trong ứng dụng desktop tôi vẫn chưa tìm thấy cách đăng nhập.
    • Remark.ing trông thật sự hay. Tôi từng cân nhắc làm một thứ giống Memos dựa trên tệp Markdown thay cho cơ sở dữ liệu quan hệ để dùng cá nhân, và cái này khá gần với thứ tôi đang tìm.
      Không biết có kế hoạch mở mã nguồn không. Tôi không tìm thấy trên GitHub.
    • Tôi tò mò sự khác nhau giữa gói miễn phí và gói thuê bao hằng tháng là gì.

  • Dự án này làm tôi nhớ đến dự án của cheeaun. Nó cho phép tạo timeline trực quan bằng một định dạng dựa trên văn bản đơn giản, nhằm sắp xếp trực quan các sự kiện trong đời.
    https://github.com/cheeaun/life
    Tệp ví dụ trong repo có dạng như: @USERNAME's life, 24/02/1955 Born, ~1968 Summer job, 03/1976 Built a computer, 01/04/1976 Started a company, 04/1976-2011 Whole bunch of interesting events

  • Mermaid cũng hỗ trợ timeline nếu dùng phiên bản đủ mới: https://mermaid.js.org/syntax/timeline.html
    Mermaid có thể được dùng trong code block trên GitLab/GitHub và nhiều trình biên tập Markdown.

    • Biểu đồ được liên kết trông không giống cùng loại biểu đồ. Nó cho biết cái gì xảy ra sau cái gì, nhưng dường như thiếu thông tin về mỗi tác vụ mất bao lâu.
    • Tôi đã làm việc này bằng Mermaid trong vài năm, nhưng markwhen lập tức cho cảm giác dễ hơn.

  • Khá hay. Tôi là nhà phát triển đang làm một hệ thống nhật ký hàng hải điện tử bán tự động cho thuyền buồm: https://bergie.iki.fi/blog/electronic-logbook/
    Hiện tôi dùng YAML vì muốn một định dạng tệp phù hợp cho cả người và máy đọc. Markwhen cũng có thể phù hợp, ít nhất đáng cân nhắc làm định dạng xuất ra.
    Tuy nhiên, các mục của tôi có nhiều thuộc tính như tốc độ gió, tọa độ tàu, giá trị khí áp kế. Nhật ký hàng hải truyền thống được viết theo dạng bảng để ghi những thứ này, nên nếu dùng Markwhen thì có thể sẽ khá lộn xộn.
    Một ví dụ về nhật ký hàng hải trong một ngày theo định dạng hiện tại ở đây: https://github.com/meri-imperiumi/log/blob/main/_data/logboo...
    Dữ liệu kiểu này cũng đang được tôi dùng cho các phân tích như trạng thái lớp màng của cảm biến độ sâu hay quãng đường đi biển theo từng thủy thủ.

  • Cần cẩn thận. Gruber có quyền nhãn hiệu đối với “Markdown” và có vẻ không thích việc mọi người dùng tên đó
    https://blog.codinghorror.com/standard-markdown-is-now-commo...

    • Cái này không chỉ khác tên, mà lúc đó thực chất là một nỗ lực nhằm tiếp nhận Markdown. Hoàn toàn không gần với dự án này
    • Giấy phép ở đây: http://daringfireball.net/projects/downloads/Markdown_1.0.1....
      Tôi không nhớ đã thấy Gruber nhắc đến “quyền nhãn hiệu”. Điểm cốt lõi có vẻ là việc lấy tên dự án của ông ấy một cách phi đạo đức. Nó giống như ai đó lấy tên một dự án mã nguồn mở và làm cho nó trông như bản chính thức. Có thể không phải là vi phạm nhãn hiệu, nhưng cũng không phải việc tốt hay có đạo đức
    • Tôi đã tìm nhãn hiệu cho “Markdown” nhưng không thấy. Bạn có thể chỉ ra nhãn hiệu đó không?
    • Joel đã cố dùng tiêu chuẩn IETF qua cửa sau cho thứ không phải do ông ấy phát minh
      Khi không thể dùng từ “standard”, ông ấy lập tức nghĩ “làm sao để vẫn tiếp tục mà về mặt kỹ thuật vẫn tuân thủ”, rồi chọn một từ gần với Standard nhất có thể, ngầm ám chỉ nó gần như là bản định nghĩa cuối cùng
      Nếu là tôi trong tình huống đó thì tôi cũng sẽ tức giận. Nếu đặt tên là ‘Atwood Flavoured Markdown’ thì đã chẳng có vấn đề gì, nhưng Joel muốn sở hữu định nghĩa của Markdown
      Về cơ bản, các CEO công ty công nghệ tụ lại và quyết định lấy ý tưởng của người khác mà còn không hỏi xem có ổn không; thực ra mục đích chính là loại John khỏi dự án
      Họ có thể làm vậy, nhưng không thể tiếp tục dùng cả cái tên mà người đó đã tạo ra
    • John Gruber cũng rất tức giận vì trong toàn bộ đặc tả, từ Markdown không được viết hoa

  • Lại thêm một lần tái hiện Org mode của Emacs. Làm tốt đấy
    Trông rất tuyệt, nhưng nói thật Markdown là một ngôn ngữ đánh dấu tài liệu. Org mode, dù bề ngoài có phạm vi tương tự, thực chất lại gần với một định dạng lưu trữ và trao đổi dữ liệu hơn. Có vẻ khó tái tạo trong Markdown các chức năng thao tác dữ liệu và truy vấn đã được xây dựng quanh Org mode

    • Đồng ý. Việc này làm trong Org rất dễ. Nếu Org phổ biến hơn, có lẽ nhiều giải pháp kiểu này đã biến mất, hoặc chỉ còn là các dự án nhỏ đọc thuộc tính Org
      Điểm mấu chốt có lẽ là hỗ trợ trình soạn thảo dễ dùng như VS Code, và có thể cả trình soạn thảo chuyên dụng còn tốt hơn nữa
    • Ví dụ có https://github.com/legalnonsense/elgantt/, https://github.com/elsatch/org-timeline-viewer, https://orgmode.org/worg/org-tutorials/org-taskjuggler.html
      Người dùng Org-mode và những công cụ như thế dường như gắn với nhau như thiêu thân với lửa. Bản thân Org-mode đã là một gói phần mềm khá ngách, nên số lượng gói được viết trên nó luôn làm tôi ngạc nhiên
    • Tôi rất muốn thật sự thích Org mode nhưng không được. Cú pháp của nó khiến tôi thấy quá gượng gạo. Markdown chỉ như dùng thêm vài ký hiệu, còn Org mode ở một số khía cạnh lại có cảm giác như đang viết LaTeX
      MediaWiki cũng tương tự. Tôi thích hệ thống wiki, nhưng WikiText thì quá tệ

  • Tôi tự hỏi liệu cái này có dùng được cho dòng thời gian giả tưởng không
    Tôi từng muốn tạo một timeline kiểu title: History of the World, 0: Foo Calendar's civilization founding., 124: Invention of the Foo Calendar, 220: Founding of Bar, 1310: Invention of GlooblyGock, 5621: Demon invasion.
    Tự thử thì có vẻ không phù hợp cho mục đích này

  • Để lại bình luận vì nếu phần bình luận trống thì có vẻ kỳ. Tôi không có nhiều điều để nói, nhưng nó trông thật sự rất hay, và hy vọng một ngày nào đó tôi sẽ có cớ để dùng

  • Dành cho những ai như tôi chưa biết, cái này cũng có thể dùng như plugin Obsidian: https://obsidian.md/plugins?search=markw

  • Có thể lấy một chút yếu tố thẩm mỹ từ đây không? https://www.chronoflotimeline.com/timeline/shared/3118/Home-...

    • Đó là sản phẩm của tôi. Cảm ơn vì đã nhắc đến
    • Lấy thì được, nhưng mong là bỏ phần độ trễ đi. Tôi đã thử bằng Firefox và Safari trên M2 Macbook Air đời 2022, phản hồi khá chậm