starred/ArchiveBox

Fork 0

mirror of https://github.com/ArchiveBox/ArchiveBox.git synced 2026-04-25 09:06:02 +03:00

[GH-ISSUE #1711] Website: Broken Markdown (un-formatted links and code) in accordions on main ArchiveBox website #2535

New issue

Open

opened 2026-03-01 17:59:41 +03:00 by kerem · 1 comment

kerem commented

2026-03-01 17:59:41 +03:00

Owner

Originally created by @tatianaanthony on GitHub (Nov 17, 2025).
Original GitHub issue: https://github.com/ArchiveBox/ArchiveBox/issues/1711

Originally assigned to: @pirate on GitHub.

What is the URL of the page you'd like to see improved?

archivebox.io

What is the title of the relevant section?

Comparison to Other Options

What is the suggested edit?

The accordions/dropdowns in the ArchiveBox.io main website appear to not parse markdown. See image, in the bottom paragraph, where the links to other sites are showing the ()[] formatting used in markdown.

The same sort of thing occurs in the Markdown Development section: Within the accordion, the subheadings are shown as #s and the code sections are shown with their enclosing ````` marks.

Based on the website theme, I suspect you're using Jekyll with Kramdown. But when using <details><summary> blocks for the accordions, I've found that you need to do one of the following:

use HTML within those sections, rather than markdown
add <span markdown="1">content with [markdown](markdownguide.org) **formatting**</span> around any sections that need markdown formatting
use <details markdown="span"> or <details markdown="block"> (though theses can potentially cause other unwanted behavior

Other accordion formatting likely needs similar fixes.

Hope this helps!

Originally created by @tatianaanthony on GitHub (Nov 17, 2025). Original GitHub issue: https://github.com/ArchiveBox/ArchiveBox/issues/1711 Originally assigned to: @pirate on GitHub. ### What is the URL of the page you'd like to see improved? archivebox.io ### What is the title of the relevant section? Comparison to Other Options ### What is the suggested edit? The accordions/dropdowns in the ArchiveBox.io main website appear to not parse markdown. See image, in the bottom paragraph, where the links to other sites are showing the ```()[]``` formatting used in markdown. <img width="1198" height="875" alt="Image" src="https://github.com/user-attachments/assets/f8552f7e-afa7-494e-abe9-7351f06625da" /> The same sort of thing occurs in the Markdown Development section: Within the accordion, the subheadings are shown as ```#```s and the code sections are shown with their enclosing ````` marks. <img width="1188" height="837" alt="Image" src="https://github.com/user-attachments/assets/0204cf39-a16b-45bc-9bd4-42bc3e3581c4" /> Based on the website theme, I suspect you're using Jekyll with Kramdown. But when using ```<details><summary>``` blocks for the accordions, I've found that you need to do one of the following: * use HTML within those sections, rather than markdown * add ```<span markdown="1">content with [markdown](markdownguide.org) **formatting**</span>``` around any sections that need markdown formatting * use ```<details markdown="span">``` or ```<details markdown="block">``` (though theses can potentially cause other unwanted behavior Other accordion formatting likely needs similar fixes. Hope this helps!

kerem added the

touches: docs

label

2026-03-01 17:59:41 +03:00

kerem commented

2026-03-01 17:59:42 +03:00

Author

Owner

@pirate commented on GitHub (Nov 18, 2025):

yah I know it's been like this for years, it's auto-generated from the README and I couldn't be bothered to hand-write custom html for all of it because the markdown is easier to edit and maintain

@pirate commented on GitHub (Nov 18, 2025): yah I know it's been like this for years, it's auto-generated from the README and I couldn't be bothered to hand-write custom html for all of it because the markdown is easier to edit and maintain

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/ArchiveBox#2535

No description provided.

Rows
Columns