udo/uce
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Support nested Markdown heading levels

Browse Source
This commit is contained in:
udo 2026-07-17 05:27:00 +00:00
parent 8dbff881a1
commit dbb8ae2c4b
5 changed files with 23 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
site/doc/pages/markdown_to_html.txt
View File

@ -45,6 +45,7 @@ Options:
- `options["gfm"]` defaults to `true` and turns on GitHub-style extras such as tables, task lists, autolinks, and strikethrough.
- `options["allow_html"]` defaults to `false`. When true, raw HTML blocks and inline tags may pass through as `raw_html` nodes instead of being escaped as plain text.
- `options["heading_offset"]` shifts rendered heading levels while leaving AST `level` values unchanged. The default is `0`; final levels clamp to `h1` through `h6`. Use `1` when Markdown is nested below a component-owned page title.
- `options["components"]` declares renderer extension points using normal UCE components.
Directive hook example:

4
site/tests/cli_runner.uce
View File

@ -217,7 +217,9 @@ void cli_run_doc_pages_gate()
CliHttpResponse res;
String summary;
bool ok = false;
for(u64 attempt = 0; attempt < 3; attempt++)
// Frontend GETs may serve the last complete nested component while its
// prioritized replacement compiles; cover a normal cold WASI compile.
for(u64 attempt = 0; attempt < 12; attempt++)
{
if(attempt > 0)
usleep(500000);

5
site/tests/components/markdown/heading.uce Normal file
View File

@ -0,0 +1,5 @@
COMPONENT(Request& context)
{
DValue& node = context.props["node"];
<><div class="tests-heading" data-hook="heading" data-source-level="<?= std::to_string(node["level"].to_u64()) ?>"><?: context.props["default_html"].to_string() ?></div></>
}

11
site/tests/markdown.uce
View File

@ -23,12 +23,21 @@ RENDER(Request& context)
DValue ast = markdown_to_ast(markdown_src, options);
String ast_json = json_encode(ast);
String html = markdown_to_html(markdown_src, options);
DValue heading_options;
heading_options["heading_offset"] = "1";
heading_options["components"]["node.heading"] = "components/markdown/heading";
String shifted_headings = markdown_to_html("# Page child\n\n###### Deep child", heading_options);
DValue negative_heading_options;
negative_heading_options["heading_offset"] = "-2";
String clamped_headings = markdown_to_html("# Top\n\n### Third", negative_heading_options);
String ast_excerpt = ast_json.substr(0, ast_json.length() > 220 ? 220 : ast_json.length());
site_tests_page_start("Markdown", "Markdown parser coverage with component-backed directive and node hooks.");
check("markdown_to_ast()", ast_json.find("heading") != String::npos || ast_json.find("code_block") != String::npos, ast_excerpt);
check("markdown_to_html()", html.find("<h1") != String::npos && html.find("tests-warning") != String::npos, html);
check("heading offset preserves source AST and shifts default hook HTML", shifted_headings.find("data-hook=\"heading\"") != String::npos && shifted_headings.find("data-source-level=\"1\"") != String::npos && shifted_headings.find("<h2>Page child</h2>") != String::npos && shifted_headings.find("<h6>Deep child</h6>") != String::npos && shifted_headings.find("<h1>") == String::npos, shifted_headings);
check("negative heading offset clamps at h1", clamped_headings.find("<h1>Top</h1>") != String::npos && clamped_headings.find("<h1>Third</h1>") != String::npos, clamped_headings);
check("component hook output", html.find("tests-code-block") != String::npos, html);
?><div class="tests-section">
@ -38,4 +47,4 @@ RENDER(Request& context)
site_tests_summary(passed, failed, skipped, "The warning directive and code-block renderer both run through local component fixtures under site/tests/components/markdown.");
site_tests_page_end();
}
}

4
src/lib/markdown.cpp
View File

@ -1218,6 +1218,10 @@ String markdown_render_node(DValue node, DValue& options)
else if(type == "heading")
{
s64 level = int_val(markdown_get_string(node, "level", "1"));
s64 heading_offset = int_val(markdown_get_string(options, "heading_offset", "0"));
if(heading_offset < -5) heading_offset = -5;
if(heading_offset > 5) heading_offset = 5;
level += heading_offset;
if(level < 1) level = 1;
if(level > 6) level = 6;
html = String("<h") + level + ">" + children_html + String("</h") + level + ">";