Md To Docx

Guideline Style

Based on create_ria_guideline.py.

• Section headings: Numbered boxes (1 2 3) via add_section_heading(doc, number, title)
• Roman sections: Also available via add_roman_section(doc, roman, title)
• Table titles: Angle bracket format <제목> via add_table_title(doc, title, indent=0.19)
• Document title: add_heading_text(doc, text, size=18, bold=True, alignment=CENTER)
• End mark: Written directly (no helper function)
• Checkbox items (□): add_checkbox_item(doc, keyword, content, bold_keyword=True)
• Circle bullets (ㅇ): add_circle_bullet_item(doc, content, bold_keyword=None)
• Diamond notes (◇): add_diamond_note(doc, content)
• Sub notes (※): add_sub_note(doc, content, indent=0.5)
• Arrow items (→): add_arrow_item(doc, content, indent=0.7)
• Circled numbers (①②③): add_numbered_sub_item(doc, number, content, bold_number=True)
• Dash items: add_dash_item(doc, content, indent=1.2) (adjustable indent)
• Plain paragraph: add_plain_paragraph(doc, content, size=11, indent=0)
• Info box: add_info_box(doc, title, content_lines)
• set_font: Has color=(R,G,B) parameter
• create_table: Has col_widths=[cm, cm, ...] parameter
• set_paragraph_format: Utility available

Related Files

Workflow

1. Read the source markdown file
2. Determine style variant (report vs guideline):
   • If --style report or --style guideline is specified, use that
   • If the markdown contains □, ㅇ, ◇, numbered box headings (1 Title), default to guideline
   • If the markdown contains I., II., III. Roman numeral headings, default to report
   • If unclear, ask the user
3. Analyze markdown structure: Identify headings, lists, tables, special markers, footnotes
4. Map each element to the correct python-docx function (see Mapping Rules below)
5. Generate a create_*.py script in the same directory as the source markdown (or in the reports directory)
6. Run with uv run python create_*.py (or python create_*.py if python-docx is available)
7. Verify the output: .docx file exists and size > 10KB

Markdown-to-Function Mapping Rules

Both Styles

Guideline Style Only

Special: • bullet (Dot Bullet)

Both have identical formatting: 11pt, indent 1.0cm, hanging -0.4cm.

Item Type Reference (All 14 Types)

* = adjustable via parameter

Page & Font Settings

These MUST be set at the top of every generated script:

from docx import Document
from docx.shared import Pt, Cm, Inches, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.table import WD_TABLE_ALIGNMENT
from docx.oxml.ns import qn
from docx.oxml import OxmlElement

doc = Document()

# Page setup - Letter size, 2.54cm margins
section = doc.sections[0]
section.page_width = Cm(21.59)    # or Inches(8.5)
section.page_height = Cm(27.94)   # or Inches(11)
section.top_margin = Cm(2.54)
section.bottom_margin = Cm(2.54)
section.left_margin = Cm(2.54)
section.right_margin = Cm(2.54)

• Font: 나눔명조 (NanumMyeongjo) for all text
• Line spacing: 1.15x for all paragraphs and table cells
• Page number: Footer, center, 나눔명조 10pt (report style adds via add_page_number())

Utility Functions Reference

Core Utilities (include in every script)

def set_font(run, font_name='나눔명조', size=11, bold=False, color=None):
    run.font.name = font_name
    run._element.rPr.rFonts.set(qn('w:eastAsia'), font_name)
    run.font.size = Pt(size)
    run.font.bold = bold
    if color:
        run.font.color.rgb = RGBColor(*color)

def set_line_spacing(paragraph, multiplier=1.15):
    pPr = paragraph._p.get_or_add_pPr()
    spacing = OxmlElement('w:spacing')
    spacing.set(qn('w:line'), str(int(240 * multiplier)))
    spacing.set(qn('w:lineRule'), 'auto')
    pPr.append(spacing)

def set_collapsible_heading(paragraph, outline_level=1):
    pPr = paragraph._p.get_or_add_pPr()
    outlineLvl = OxmlElement('w:outlineLvl')
    outlineLvl.set(qn('w:val'), str(outline_level - 1))
    pPr.append(outlineLvl)

Guideline-only Utility

def set_paragraph_format(paragraph, left_indent=None, first_line_indent=None,
                         space_before=None, space_after=None):
    pf = paragraph.paragraph_format
    if left_indent is not None:
        pf.left_indent = Cm(left_indent)
    if first_line_indent is not None:
        pf.first_line_indent = Cm(first_line_indent)
    if space_before is not None:
        pf.space_before = Pt(space_before)
    if space_after is not None:
        pf.space_after = Pt(space_after)

Footnote Functions (when markdown contains footnotes)

def create_footnote(doc, paragraph, footnote_text):
    # Creates a Word footnote with superscript reference
    # Footnote content: 9pt 나눔명조
    ...

def save_doc_with_footnotes(doc, filepath):
    # Must use this instead of doc.save() when footnotes are present
    ...

Script Generation Rules

1. File naming: create_{descriptive_name}.py based on the markdown filename
2. Output naming: {Descriptive_Name}.docx in the same directory or specified output path
3. Include only needed functions: Report style scripts don't need guideline-only functions and vice versa
4. Blank lines between sections: Always add doc.add_paragraph() between major sections (after section headings, between numbered item groups)
5. Bold keyword detection: When markdown has **keyword** rest of text, extract and pass as bold_keyword parameter
6. Table parsing: Parse markdown tables (| header | header |) into headers list and rows list of lists
7. Department/date line: Look for a line like 부서명(YYYY.MM) right after the title

Exceptions & Edge Cases

Output Format

After successful execution, report:

• Generated script path: create_*.py
• Output DOCX path: *.docx
• File size confirmation (should be > 10KB)
• Number of pages (approximate based on content length)