Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

read: paragraph text that looks like a Markdown block becomes structure on publish

Đã đóng
#203 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
74/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go, markdown
Lĩnh vực
cli

Hướng nghiên cứu

Start in storage_to_md.go at renderBlock's block-level p case, then trace the read → publish path described in the issue. Cover the listed leading Markdown block markers, including HTML and table-like lines, and verify that escaped paragraph text remains unchanged after another read → publish cycle.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

bug

Problem

`read` and `export` write a paragraph's text as Markdown without escaping a leading block marker, so text that looks like a Markdown block turns into that block on the next publish. Found in the second review of #55.

Reproduced 2026-09-25 (read → publish):

storage read writes publish sends
`

1. not a list

`
`1. not a list` `
  1. not a list
`
`

# not heading

`
`# not heading` `

not heading

`
`

> 5 errors

`
`> 5 errors` `

5 errors

`

The page's content changes silently on a read → update cycle, and the Markdown is a fixed point after the first cycle, so no round-trip test notices. It affects every paragraph `read` writes: top level, layout cells, macro bodies, and (since #55) raw table cells. A GFM pipe-table cell is not affected, because its text is inline.

Notes

  • The fix belongs where `storage_to_md.go` renders a block-level `

    ` (`renderBlock`'s `p` case), escaping a leading marker with a backslash (`1\.`, `\#`, `\>`).

  • The markers to cover include `-`, `+`, `*`, `1.`/`1)`, `#`, `>`, a line that is only `---`/`===` (a thematic break or a setext underline), four leading spaces (indented code), and `|` if a line could read as a table row. Probably also a leading `<` that would start an HTML block.
  • The escape must survive the next read, so the Markdown stays a fixed point.
Ngôn ngữ chính
Go
Star
4
Fork
1
Merge trung bình
1 giờ 35 phút
Pull request đã merge (30 ngày)
39

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của mozilla/markfluence

Tất cả issue của mozilla/markfluence

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.