# Markdown-to-PDF editorial source notes

Checked: `2026-08-12` (Asia/Calcutta)

These sources support the format and reader guidance in `draft.md`. Product behavior and measurements come from `test-record.md`, not from external documentation.

## Primary guidance

### CommonMark specification 0.31.2

- URL: <https://spec.commonmark.org/0.31.2/>
- Verified response: HTTP 200 on `2026-08-12`.
- Used for: Markdown is a plain-text structured-document format; the core syntax covers headings, thematic breaks, code blocks, block quotes, lists, emphasis, links, images, and raw HTML.
- Editorial constraint: CommonMark describes syntax, not LocalFlux's supported-input boundary or physical PDF layout.

### Markdig

- URL: <https://github.com/xoofx/markdig>
- Verified response: HTTP 200 on `2026-08-12`.
- Used for: Markdig is a CommonMark-oriented, extensible Markdown processor for .NET.
- Local implementation check: `src/LocalFlux.Core/Services/MarkdownDocumentRenderer.cs` enables advanced extensions and disables raw HTML.

### LibreOffice PDF export links

- URL: <https://help.libreoffice.org/latest/en-US/text/shared/01/ref_pdf_export_links.html>
- Verified response: HTTP 200 on `2026-08-12`.
- Used for: PDF export can preserve document hyperlinks.
- Editorial constraint: the article claims only the measured internal fragment-link result, not universal link preservation.

### Microsoft Edge print guidance

- URL: <https://support.microsoft.com/en-us/edge/print-in-microsoft-edge>
- Verified response: HTTP 200 on `2026-08-12`.
- Used for: Edge offers print and print-preview controls suitable for a final document review.
- Editorial constraint: the verification checklist is reader-independent; Edge is an example, not a requirement.

### Google Workspace Markdown import/export update

- URL: <https://workspaceupdates.googleblog.com/2024/07/import-and-export-markdown-in-google-docs.html>
- Checked on `2026-08-12`.
- Background only: Google added Markdown import/export options to Docs in 2024, illustrating use beyond developer-only files.
- This article does not rely on Google Docs for the conversion procedure or any LocalFlux claim.

## Local editorial references

- `docs/research/localflux-next-blog-topics-2026-08.md` selected Markdown-to-PDF as the fifth route article and described it as clean document-cluster expansion.
- `src/LocalFlux.Core/Data/routes.json` exposes the Markdown-to-PDF document route.
- `src/LocalFlux.Core/Services/MarkdownDocumentRenderer.cs` rejects raw HTML and remote HTTP(S) links or images before local rendering.
- `src/LocalFlux.Core/Data/routes.json` assigns `document.md-to-pdf` to the LibreOffice runtime.

## Claim boundaries

- No network-adapter-disabled or clean-VM claim is made.
- No universal page count, file size, font, link, or formatting guarantee is made.
- No claim is made that relative local image paths work in every location.
- No claim is made that local conversion removes sensitive metadata or makes a PDF safe to share.
- Exact layout control is explicitly out of scope for the direct route.
