39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# Markdown Schema Contract: Output Article Markdown
|
|
|
|
**Feature**: `005-convert-json-markdown` | **Date**: 2026-08-21
|
|
|
|
## 1. Output Document Specification
|
|
|
|
The generated Markdown document MUST strictly adhere to the following template structure:
|
|
|
|
```markdown
|
|
# {Resolved Title}
|
|
|
|
{Resolved Subtitle/Description - OMITTED IF ABSENT OR EQUAL TO TITLE}
|
|
|
|
**Autor:** {Resolved Authors joined by ", " - OMITTED IF ABSENT}
|
|
**Publicado em:** {Resolved Publication Date - OMITTED IF ABSENT}
|
|
**Site:** {Resolved Site Name - OMITTED IF ABSENT}
|
|
**Categoria:** {Resolved Categories joined by ", " - OMITTED IF ABSENT}
|
|
**Tags:** {Resolved Tags joined by ", " - OMITTED IF ABSENT}
|
|
**Palavras-chave:** {Resolved Keywords joined by ", " - OMITTED IF ABSENT}
|
|
**Idioma:** {Resolved Language Code - OMITTED IF ABSENT}
|
|
**Fonte original:** [{Resolved Original URL}]({Resolved Original URL})
|
|
|
|
|
|
|
|
---
|
|
|
|
{Converted Markdown Body Content}
|
|
```
|
|
|
|
## 2. Formatting & Syntax Constraints
|
|
|
|
1. **Character Encoding**: UTF-8 without BOM.
|
|
2. **Line Delimiters**: UNIX-style `LF` (`\n`).
|
|
3. **Trailing Whitespace**: Stripped from every line.
|
|
4. **Blank Lines**: Maximum of 2 consecutive newline characters (`\n\n`), preventing excessive vertical spacing.
|
|
5. **EOF Delimiter**: Ends with exactly one trailing newline character (`\n`).
|
|
6. **No Placeholders**: Never print `null`, `None`, `N/A`, `unknown`, `[no-author]`, or empty metadata labels (e.g. `**Autor:** `).
|
|
7. **No Internal Leakage**: Never output `selected_extractor` name, scoring metrics, or JSON internals in the final document.
|