fix: cap markdown heading levels at h6 and remove egg-info artifacts

CommonMark only supports h1-h6; at nesting depth >= 3 the heading formula
`depth * 2` would produce 7+ hashes which renders as plain text. Now falls
back to bold text (**`name`** / **Member variables:**) for levels beyond h6.

Also removes yamldoc.egg-info/ from git tracking (already in .gitignore,
accidentally included from a prior rebase).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Chris1221

test/test_examples.py

@@ -284,6 +284,20 @@ def test_deeper_nesting(self):
         self.assertTrue(output == proper_markdown)
 
 
+    def test_heading_levels_cap_at_h6(self):
+        inner = yamldoc.entries.MetaEntry("leaf", "#' leaf doc", "#'")
+        inner.entries.append(yamldoc.entries.Entry("k", "v", "#' doc", "#'"))
+        outer = yamldoc.entries.MetaEntry("deep", "#' deep doc", "#'")
+        outer.entries.append(inner)
+
+        md3 = outer.to_markdown(depth=3)
+        self.assertIn("###### `deep`", md3)
+        self.assertIn("**Member variables:**", md3)
+
+        md4 = outer.to_markdown(depth=4)
+        self.assertIn("**`deep`**", md4)
+
+
 class TestEdgeCases(unittest.TestCase):
     def test_ordinary_comment_without_colon(self):
         # Regression test for issue #26

yamldoc.egg-info/PKG-INFO

@@ -135,17 +135,28 @@ def to_markdown(self, schema=False, depth=1):
 
         self.check_for_lists()
 
-        h_section = "#" * (depth * 2)
-        h_members = "#" * (depth * 2 + 1)
+        section_level = depth * 2
+        members_level = depth * 2 + 1
 
-        output = f"{h_section} `{self.name}`\n\n{self.meta.lstrip()}\n\n"
+        # CommonMark caps heading levels at h6; fall back to bold text beyond that
+        if section_level <= 6:
+            section_header = f"{'#' * section_level} `{self.name}`"
+        else:
+            section_header = f"**`{self.name}`**"
+
+        if members_level <= 6:
+            members_header = f"{'#' * members_level} Member variables:"
+        else:
+            members_header = "**Member variables:**"
+
+        output = f"{section_header}\n\n{self.meta.lstrip()}\n\n"
 
         entries_to_print = self.non_excluded_entries()
         if len(entries_to_print) == 0:
             output += "No member variables.\n\n"
             return output
 
-        output += f"{h_members} Member variables:\n\n"
+        output += f"{members_header}\n\n"
         output += self.table_header(schema)
 
         nested_meta_entries = []