Online Doc HTML

Online Doc HTML

Overview

Use this skill to turn local Markdown into standalone HTML that can be opened in a browser, selected, copied, and pasted into online document editors with less formatting cleanup.

The default output is HTML only. Do not generate DOCX unless the user explicitly asks for it.

Workflow

1. Identify the Markdown files the user wants to sync or copy.
2. Prefer a repo-local export script if one already exists and is clearly maintained for that repo.
3. Otherwise run the bundled script:

~/.codex/skills/online-doc-html/scripts/export_online_doc_html.sh --out build/online-doc-html <file1.md> <file2.md>

4. Open the generated HTML file in a browser, select the article body, copy it, and paste into the online document editor.
5. If images still fail to paste, treat it as an online editor clipboard/upload limitation. The next step is browser automation to insert or upload images, not more HTML tuning.

Bundled Script

Use scripts/export_online_doc_html.sh.

Behavior:

• Converts each Markdown file to standalone HTML via pandoc.
• Converts referenced .svg images to .png with rsvg-convert before HTML export.
• Embeds images and CSS into the generated HTML with pandoc --embed-resources.
• Writes output to build/online-doc-html by default.
• Generates targets.tsv with source Markdown and output HTML paths.
• Removes stale DOCX files from the output directory because DOCX is not the default path.

Dependencies:

• Required: pandoc.
• Required for SVG diagrams: rsvg-convert from librsvg.

On macOS:

brew install pandoc librsvg

Output Guidance

Tell the user:

• Which HTML files were generated.
• Whether SVG references were fully replaced by PNG images.
• Whether any image references could not be resolved.
• That no online document was modified unless browser automation or API update was explicitly requested and confirmed.

Guardrails

• Do not overwrite or save online documents without explicit user confirmation.
• Do not reverse-engineer private save APIs as the first approach. Prefer paste-friendly HTML first.
• Keep generated artifacts in ignored build/output directories when working inside a repo.