ฉันจะสร้างสารบัญสำหรับเอกสาร markdown ด้วย Python / AWK / SED ได้อย่างไร

ฉันมีเอกสาร markdown ต่อไปนี้:

Heading-a
==========

---text---

Heading-b
------------

--- text ---

Heading-c
----------

--- text---

Heading-d
=======

--- text----

Heading-e
---

...

ฉันต้องการสร้างสารบัญที่สามารถคลิกได้ซึ่งคล้ายกับที่LaTexทำ แต่ไม่สามารถหาเครื่องมือที่ทำสิ่งนี้ซึ่งแนะนำให้ฉันรู้ว่าเราควรสร้างขึ้นมาหนึ่งอัน

เครื่องมือควรรวบรวมส่วนหัว 'H1' และส่วนหัว 'H2' เพื่อให้ได้หมายเลข 1 ถึงHeading-aและหมายเลข 1.1 เป็นHeading-b1.2 ถึงHeading-c, 2. ถึงHeading-d, 2.1 ไปHeading-eเรื่อย ๆ เช่นที่เราควรได้รับสารบัญต่อไปนี้:

  1. Heading-a
  1.1. Heading-b
  1.2. Heading-c
  2. Heading-d
  2.1. Heading-e

ฉันจะทำสิ่งนี้กับ Python / AWK / SED ได้อย่างไร

การใช้Markdown ใน Pythonนั้นรองรับส่วนขยายอย่างใดอย่างหนึ่งซึ่งรวมถึงการสร้างสารบัญ นอกจากนี้Pandoc (ซึ่งเป็น Haskell markup-> PDF มีการรองรับสำหรับ markdown (นอกเหนือจากรูปแบบอื่น ๆ ) และสามารถส่งออก HTML, LaTeX, PDF และอื่น ๆ ได้

หากคุณมีส่วนหัวอยู่แล้วคุณสามารถลองgithub-markdown-tocเพื่อประมวลผลไฟล์ stdin, โลคัลและรีโมตตัวอย่างเช่น:

cat ~/projects/Dockerfile.vim/README.md | ./gh-md-toc -

หรือสร้างท้องถิ่นREADME.md:

./gh-md-toc ~/projects/Dockerfile.vim/README.md

ดูบทความนี้สำหรับการเปรียบเทียบภาษามาร์กอัปน้ำหนักเบาพร้อมข้อมูลบางอย่างในสารบัญที่อาจนำคุณไปสู่การแก้ไขปัญหา