@imontene/mdrender 2.2.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Cambios
 
+## 2.4.0 — 2026-10-22
+
+- **Párrafos justificados en el PDF**: los del texto, las citas y las alertas, con partición de
+  palabras según el idioma del documento (español, inglés, portugués, francés, alemán e
+  italiano). Listas, tablas, notas al pie, índice y diagramas siguen alineados a la izquierda,
+  y el HTML no cambia. `--no-justify` (o `justify: false`) lo desactiva. El texto del PDF solo
+  lleva el guion donde una palabra se corta: copiar y buscar siguen funcionando.
+
+## 2.3.0 — 2026-10-16
+
+- **Manrope es la nueva tipografía por defecto** del texto, el encabezado, el pie y los
+  diagramas Mermaid. `--font inter` (o `font: inter`) conserva Inter, la de versiones
+  anteriores. Manrope no tiene cursivas (el navegador inclina la normal) y toma de Inter los
+  símbolos que le faltan (`→`, `✓`, `≤`…).
+
 ## 2.2.0 — 2026-10-15
 
 - **Autoajuste de diagramas de flujo Mermaid** (`flowchart`/`graph`): cada diagrama se dibuja

package/README.md

@@ -2,7 +2,7 @@
 
 **Convierte archivos Markdown (`.md`) en PDF y HTML desde la línea de comandos, en Windows y
 Linux**, con ecuaciones LaTeX, diagramas Mermaid y la tipografía
-[Inter](https://fonts.google.com/specimen/Inter).
+[Manrope](https://fonts.google.com/specimen/Manrope) (o [Inter](https://fonts.google.com/specimen/Inter)).
 
 ```bash
 mdrender informe.md            # → informe.pdf
@@ -15,7 +15,8 @@ Ejemplo: [`examples/ejemplo.md`](examples/ejemplo.md) → [`examples/ejemplo.pdf
 - 📄 **Markdown → PDF o HTML autocontenido** (fuentes, imágenes y diagramas incluidos).
 - ➗ **Ecuaciones** `$…$` y `$$…$$` con KaTeX, dibujadas al convertir (sin JavaScript en la salida).
 - 📊 **Diagramas Mermaid**: flujo, secuencia, clases, estados, ER, Gantt, torta, mapa mental…
-- 🔤 **Inter** para el texto y **JetBrains Mono** para el código, incrustadas en el PDF.
+- 🔤 **Manrope** para el texto (o **Inter** con `--font inter`) y **JetBrains Mono** para el
+  código, incrustadas en el PDF.
 - 🧩 **GFM**: tablas, listas de tareas, tachado, notas al pie, alertas `> [!NOTE]`,
   resaltado de código para ~35 lenguajes.
 - 🖨️ Tamaño de página, márgenes, orientación, encabezado/pie con números de página,
@@ -151,6 +152,8 @@ equipo); `--port` fija el puerto y `--no-open` no abre el navegador.
 | `--header <texto>`             | Encabezado de página (ver abajo)                                     | —                  |
 | `--footer <texto>`             | Pie de página (ver abajo)                                            | `{page} / {pages}` |
 | `--no-page-numbers`            | Sin el pie con números de página                                     | —                  |
+| `--font <manrope\|inter>`      | Tipografía del texto (ver abajo)                                     | `manrope`          |
+| `--no-justify`                 | Párrafos alineados a la izquierda en el PDF (ver abajo)              | justificado        |
 | `--density <densidad>`         | `normal` o `compact` (menos espacio entre líneas y bloques)          | `normal`           |
 | `--font-size <tamaño>`         | Tamaño del texto en `pt` o `px`, de 6 a 24 pt; p. ej. `10pt`         | `10.5pt`           |
 | `--theme <light\|dark\|css>`   | `light`, `dark` o un `.css` que reemplaza el tema                    | `light`            |
@@ -175,6 +178,21 @@ equipo); `--port` fija el puerto y `--no-open` no abre el navegador.
 El encabezado y el pie se dibujan dentro de las márgenes superior e inferior: con menos de
 10 mm pueden tocar el texto y mdrender lo advierte.
 
+**Tipografía**: el texto usa [Manrope](https://fonts.google.com/specimen/Manrope);
+`--font inter` (o `font: inter` en el front matter o en `mdrender.config.json`) vuelve a
+[Inter](https://fonts.google.com/specimen/Inter), la tipografía de las versiones anteriores.
+Ambas van incrustadas en el PDF, también en el encabezado, el pie y los diagramas. Manrope no
+tiene cursivas (el navegador inclina la normal) ni algunos símbolos como `→`, `✓` o `≤`, que
+se toman de Inter.
+
+**Párrafos justificados**: en el PDF, los párrafos del texto, de las citas y de las alertas
+se justifican, y las palabras largas se parten con guion al final de la línea según el idioma
+del documento (`lang`: español, inglés, portugués, francés, alemán o italiano; en otros idiomas
+se justifica sin partir palabras). Listas, tablas, notas al pie, el índice y los diagramas
+quedan alineados a la izquierda, igual que el HTML. El texto del PDF solo lleva el guion donde
+la palabra se corta, así que copiar y buscar funcionan con las palabras completas.
+`--no-justify` (o `justify: false`) vuelve a alinear a la izquierda.
+
 **Aprovechar la página**: `--density compact` reduce interlineado, espacios entre párrafos y
 títulos, y `--font-size 10pt` achica el texto (los diagramas Mermaid siguen el mismo tamaño).
 Juntos ahorran entre un 15 y un 25 % de páginas. Además, siempre:
@@ -318,6 +336,6 @@ cambios: [CHANGELOG.md](CHANGELOG.md).
 
 ## Licencia
 
-[MIT](LICENSE). Inter y JetBrains Mono se distribuyen bajo la
+[MIT](LICENSE). Manrope, Inter y JetBrains Mono se distribuyen bajo la
 [SIL Open Font License 1.1](https://openfontlicense.org); los ejecutables incluyen
 `THIRD-PARTY-NOTICES.txt` con las licencias de todos los componentes.

package/dist/assets/theme.css

@@ -1,7 +1,8 @@
-/* mdrender light theme — Inter for text, JetBrains Mono for code. */
+/* mdrender light theme — Manrope (or Inter) for text, JetBrains Mono for code. */
 
 :root {
-  --font-text: "Inter", system-ui, sans-serif;
+  /* mdrender sets both after the theme for the chosen --font (render/fonts.ts). */
+  --font-text: "Manrope", "Inter", system-ui, sans-serif;
   /* Inter after the mono font covers symbols (arrows, math) missing from the code font. */
   --font-code: "JetBrains Mono", "Inter", ui-monospace, monospace;
   --color-text: #1f2328;

package/dist/assets.d.ts

@@ -31,6 +31,8 @@ export declare const INTER_FACES: readonly [{
     readonly style: "italic";
     readonly file: "Inter-BoldItalic.woff2";
 }];
+/** Manrope faces in use (Fontsource, split into unicode-range subsets); it has no italics. */
+export declare const MANROPE_STYLESHEETS: string[];
 export declare const MONO_STYLESHEETS: string[];
 export declare const KATEX_CSS = "katex/dist/katex.min.css";
 export declare const MERMAID_JS = "mermaid/dist/mermaid.min.js";

package/dist/assets.js

@@ -78,6 +78,12 @@ export const INTER_FACES = [
     { weight: 700, style: "normal", file: "Inter-Bold.woff2" },
     { weight: 700, style: "italic", file: "Inter-BoldItalic.woff2" },
 ];
+/** Manrope faces in use (Fontsource, split into unicode-range subsets); it has no italics. */
+export const MANROPE_STYLESHEETS = [
+    "@fontsource/manrope/400.css",
+    "@fontsource/manrope/600.css",
+    "@fontsource/manrope/700.css",
+];
 export const MONO_STYLESHEETS = [
     "@fontsource/jetbrains-mono/400.css",
     "@fontsource/jetbrains-mono/400-italic.css",
@@ -103,7 +109,7 @@ export function assetManifest() {
     const keys = new Set([PACKAGE_JSON, ...THEMES, MERMAID_JS]);
     for (const { file } of INTER_FACES)
         keys.add(`${INTER_DIR}/${file}`);
-    for (const cssKey of [...MONO_STYLESHEETS, KATEX_CSS]) {
+    for (const cssKey of [...MANROPE_STYLESHEETS, ...MONO_STYLESHEETS, KATEX_CSS]) {
         keys.add(cssKey);
         for (const font of woff2References(cssKey, readTextAsset(cssKey)))
             keys.add(font);

package/dist/cli.js

@@ -25,6 +25,8 @@ const DOCUMENT_FLAGS = [
     "header",
     "footer",
     "pageNumbers",
+    "font",
+    "justify",
     "density",
     "fontSize",
     "css",
@@ -35,6 +37,8 @@ const DOCUMENT_FLAGS = [
     "lang",
     "title",
 ];
+/** Options set on the command line only through their --no-… form. */
+const NEGATED_FLAGS = new Set(["pageNumbers", "mermaidAutofit", "justify"]);
 const toFlag = (key) => "--" + key.replace(/[A-Z]/g, (c) => "-" + c.toLowerCase());
 export const defaultIo = {
     out: (text) => process.stdout.write(text),
@@ -57,6 +61,8 @@ function addDocumentOptions(command) {
         .option("--header <text>", 'page header, e.g. "{title} | | {date}"')
         .option("--footer <text>", 'page footer (default: "{page} / {pages}")')
         .option("--no-page-numbers", "no default page-number footer")
+        .option("--font <font>", "text typeface: manrope or inter (default: manrope)")
+        .option("--no-justify", "align paragraphs left in the PDF instead of justifying them")
         .option("--density <density>", "normal or compact (tighter spacing) (default: normal)")
         .option("--font-size <size>", "text size, e.g. 10pt or 11pt (default: 10.5pt)")
         .option("--theme <theme>", "light, dark, or a .css file replacing the theme (default: light)")
@@ -77,7 +83,7 @@ function configure(command, io) {
 function buildRenderProgram(io) {
     const program = new Command()
         .name("mdrender")
-        .description("Render Markdown files to PDF (or self-contained HTML) using the Inter typeface.")
+        .description("Render Markdown files to PDF (or self-contained HTML) set in Manrope (or Inter).")
         .version(version, "-V, --version")
         .argument("<inputs...>", "Markdown files, folders or glob patterns (e.g. docs/**/*.md)")
         .option("-o, --output <path>", "output file, or folder for several inputs")
@@ -115,11 +121,7 @@ function cliOverrides(program) {
         if (program.getOptionValueSource(key) === "cli")
             raw[key] = program.getOptionValue(key);
     }
-    return normalizeOptions(raw, "command line", process.cwd(), (key) => key === "pageNumbers"
-        ? "--no-page-numbers"
-        : key === "mermaidAutofit"
-            ? "--no-mermaid-autofit"
-            : toFlag(key));
+    return normalizeOptions(raw, "command line", process.cwd(), (key) => NEGATED_FLAGS.has(key) ? `--no-${toFlag(key).slice(2)}` : toFlag(key));
 }
 function settings(program, options) {
     return {

package/dist/convert.js

@@ -12,7 +12,8 @@ import { BrowserSession } from "./render/browser.js";
 import { DEFAULT_FOOTER, headerFooterTemplate } from "./render/header-footer.js";
 import { fillMermaid, renderMermaid } from "./render/mermaid.js";
 import { SMALL_SCALE } from "./render/mermaid-fit.js";
-import { contentHeightPx, contentWidthPx, lengthToPx } from "./render/page.js";
+import { FONT_FAMILIES, fontStack } from "./render/fonts.js";
+import { contentHeightPx, contentWidthPx, lengthToPx, textWidthPx } from "./render/page.js";
 import { buildHtmlDocument, builtinThemeCss, densityCss } from "./render/template.js";
 import { writeFileAtomic } from "./write.js";
 /** Starts one browser on first use and keeps it for later conversions. */
@@ -79,10 +80,33 @@ export function headerFooterSpaceWarnings(margin, hasHeader, hasFooter) {
     }
     return warnings;
 }
+/**
+ * Justified paragraphs in the PDF: the body's, and those directly inside a quote or an alert
+ * (the same ones markdown/hyphenate.ts gives soft hyphens). Lists, tables, footnotes, the title
+ * block, the table of contents and diagram labels stay aligned left. Print only: on screen the
+ * HTML keeps ragged lines.
+ */
+const JUSTIFY_CSS = `@media print {
+  .markdown-body > p,
+  .markdown-body > blockquote > p:not(.markdown-alert-title) {
+    text-align: justify;
+  }
+}`;
 /** Font size, if set, and the page's text height (used to fit images and diagrams). */
 function layoutCss(options, margin) {
     const height = contentHeightPx(options.pageSize, options.orientation === "landscape", margin);
-    const rules = [`:root { --page-content-height: ${height}px; }`];
+    const family = FONT_FAMILIES[options.font];
+    const rules = [
+        `:root { --page-content-height: ${height}px; }`,
+        `:root { --font-text: ${fontStack(options.font)}; ` +
+            `--font-code: "JetBrains Mono", "${family}", "Inter", ui-monospace, monospace; }`,
+    ];
+    // Manrope's glyphs are taller than the headings' 1.25 line height (about 1.37 em). When a
+    // heading is pushed to the next page, Chrome then repeats its text in the PDF bookmark.
+    if (options.font === "manrope")
+        rules.push("h1, h2, h3, h4, h5, h6 { line-height: 1.4; }");
+    if (options.justify)
+        rules.push(JUSTIFY_CSS);
     if (options.fontSize)
         rules.push(`html { font-size: ${options.fontSize}; }`);
     return rules.join("\n");
@@ -125,7 +149,12 @@ paged = false) {
     const margin = resolveMargins(options);
     const themeCss = themeStylesheets(options.theme);
     const extraCss = options.css.map(readStylesheet);
-    const md = renderMarkdown(frontMatter.body, { baseDir, lang: options.lang });
+    const md = renderMarkdown(frontMatter.body, {
+        baseDir,
+        lang: options.lang,
+        // Soft hyphens only where paragraphs are justified: in the PDF.
+        hyphenate: paged && options.justify ? options.lang : undefined,
+    });
     const diagnostics = [
         ...config.warnings.map((message) => ({ severity: "warning", message })),
         ...md.diagnostics,
@@ -158,6 +187,7 @@ paged = false) {
                 : Infinity,
             autofit: options.mermaidAutofit,
             flip: options.mermaidFlip,
+            font: options.font,
         });
         const filled = fillMermaid(body, md.nonce, md.mermaid, results);
         body = filled.html;
@@ -188,6 +218,7 @@ paged = false) {
         date: options.date,
         showTitle: options.title !== undefined,
         themeCss,
+        font: options.font,
         layoutCss: [...densityCss(options.density), layoutCss(options, margin)],
         extraCss,
     });
@@ -218,10 +249,15 @@ export async function convertFile(convert) {
                 landscape: options.orientation === "landscape",
                 margin,
                 headerTemplate: hasHeaderFooter
-                    ? headerFooterTemplate(options.header, values, margin)
+                    ? headerFooterTemplate(options.header, values, margin, options.font)
+                    : undefined,
+                footerTemplate: hasHeaderFooter
+                    ? headerFooterTemplate(footer, values, margin, options.font)
                     : undefined,
-                footerTemplate: hasHeaderFooter ? headerFooterTemplate(footer, values, margin) : undefined,
                 allowRemote: convert.allowRemote,
+                softHyphensWidthPx: options.justify
+                    ? textWidthPx(options.pageSize, options.orientation === "landscape", margin)
+                    : undefined,
             });
             for (const url of blocked) {
                 const hint = /^https?:/i.test(url) ? " (use --allow-remote to download it)" : "";

package/dist/doctor.js

@@ -135,8 +135,10 @@ function settingsCheck(options) {
         name: "Settings",
         status: "info",
         detail: `${options.pageSize} ${options.orientation}, margins ${m.top} ${m.right} ${m.bottom} ` +
-            `${m.left} (top right bottom left), ${options.density} density, ` +
-            `${options.fontSize ?? DEFAULT_FONT_SIZE} text, language ${options.lang}, theme ` +
+            `${m.left} (top right bottom left), ${options.font} ` +
+            `${options.fontSize ?? DEFAULT_FONT_SIZE}, ${options.density} density, ` +
+            `${options.justify ? "justified" : "ragged"} paragraphs, ` +
+            `language ${options.lang}, theme ` +
             path.basename(options.theme),
     };
 }

package/dist/markdown/env.d.ts

@@ -22,6 +22,8 @@ export interface RenderEnv extends Env {
     hasMath: boolean;
     /** Document language, for translated labels (alert titles). */
     lang: string;
+    /** Language whose hyphenation patterns break justified paragraphs (PDF only); see hyphenate.ts. */
+    hyphenate?: string;
     /** Set when the document places its table of contents with a `[[toc]]` marker. */
     hasTocMarker: boolean;
 }

package/dist/markdown/hyphenate.d.ts

@@ -0,0 +1,14 @@
+import type { MarkdownIt } from "markdown-it";
+/**
+ * Soft hyphens (U+00AD) for justified paragraphs in the PDF, so the browser can break long
+ * words at the end of a line instead of stretching the spaces. They are inserted here, from TeX
+ * hyphenation patterns, because CSS `hyphens: auto` depends on dictionaries that Chromium and
+ * Chrome Headless Shell do not ship. When printing, the soft hyphens that did not end up at the
+ * end of a line are removed again (render/browser.ts), so they stay out of the PDF's text.
+ */
+export declare const SOFT_HYPHEN = "\u00AD";
+export declare const HYPHENATION_LANGUAGES: string[];
+/** Hyphenation function for a BCP 47 language tag ("es", "es-CL", "en-GB"), if supported. */
+export declare function hyphenatorFor(lang: string): ((text: string) => string) | undefined;
+/** Insert soft hyphens in the paragraphs that are justified in the PDF (env.hyphenate). */
+export declare function hyphenation(md: MarkdownIt): void;

package/dist/markdown/hyphenate.js

@@ -0,0 +1,92 @@
+import createHyphenator from "hyphen";
+import de from "hyphen/patterns/de-1996.js";
+import enGb from "hyphen/patterns/en-gb.js";
+import enUs from "hyphen/patterns/en-us.js";
+import es from "hyphen/patterns/es.js";
+import fr from "hyphen/patterns/fr.js";
+import it from "hyphen/patterns/it.js";
+import pt from "hyphen/patterns/pt.js";
+/**
+ * Soft hyphens (U+00AD) for justified paragraphs in the PDF, so the browser can break long
+ * words at the end of a line instead of stretching the spaces. They are inserted here, from TeX
+ * hyphenation patterns, because CSS `hyphens: auto` depends on dictionaries that Chromium and
+ * Chrome Headless Shell do not ship. When printing, the soft hyphens that did not end up at the
+ * end of a line are removed again (render/browser.ts), so they stay out of the PDF's text.
+ */
+export const SOFT_HYPHEN = "­";
+/** Hyphenation patterns by language: base language, or language-region where they differ. */
+const PATTERNS = {
+    es,
+    en: enUs,
+    "en-gb": enGb,
+    pt,
+    fr,
+    de,
+    it,
+};
+export const HYPHENATION_LANGUAGES = Object.keys(PATTERNS);
+const hyphenators = new Map();
+/** Hyphenation function for a BCP 47 language tag ("es", "es-CL", "en-GB"), if supported. */
+export function hyphenatorFor(lang) {
+    const tag = lang.trim().toLowerCase().replace(/_/g, "-");
+    const patterns = PATTERNS[tag.split("-").slice(0, 2).join("-")] ?? PATTERNS[tag.split("-")[0]];
+    if (!patterns)
+        return undefined;
+    let hyphenate = hyphenators.get(patterns);
+    if (!hyphenate) {
+        // The input is plain text from Markdown, not HTML (a literal "<" is just a character).
+        const sync = createHyphenator(patterns, { html: false });
+        hyphenate = (text) => sync(text);
+        hyphenators.set(patterns, hyphenate);
+    }
+    return hyphenate;
+}
+/**
+ * Whether a paragraph is justified: top-level, or directly inside a blockquote or alert (the
+ * same paragraphs as the print stylesheet in convert.ts). Lists, footnotes and tables are not.
+ */
+function justified(containers) {
+    return (containers.length === 0 || (containers.length === 1 && containers[0] === "blockquote_open"));
+}
+function hyphenateInline(inline, hyphenate) {
+    let inAutolink = 0;
+    for (const child of inline.children ?? []) {
+        if (child.type === "link_open" && (child.markup === "linkify" || child.markup === "autolink")) {
+            inAutolink++;
+        }
+        else if (child.type === "link_close" && inAutolink > 0) {
+            inAutolink--;
+        }
+        else if (child.type === "text" && inAutolink === 0) {
+            child.content = hyphenate(child.content);
+        }
+    }
+}
+/** Insert soft hyphens in the paragraphs that are justified in the PDF (env.hyphenate). */
+export function hyphenation(md) {
+    md.core.ruler.push("hyphenation", (state) => {
+        const lang = state.env.hyphenate;
+        const hyphenate = lang === undefined ? undefined : hyphenatorFor(lang);
+        if (!hyphenate)
+            return;
+        const containers = [];
+        for (let i = 0; i < state.tokens.length; i++) {
+            const token = state.tokens[i];
+            if (token.type === "paragraph_open") {
+                const inline = state.tokens[i + 1];
+                if (justified(containers) && inline?.type === "inline")
+                    hyphenateInline(inline, hyphenate);
+            }
+            else if (token.type === "paragraph_close") {
+                continue;
+            }
+            else if (token.nesting === 1) {
+                containers.push(token.type);
+            }
+            else if (token.nesting === -1) {
+                containers.pop();
+            }
+        }
+    });
+}
+//# sourceMappingURL=hyphenate.js.map

package/dist/markdown/index.d.ts

@@ -22,6 +22,8 @@ export interface MarkdownOptions {
     baseDir?: string;
     /** Document language for translated labels. Defaults to Spanish. */
     lang?: string;
+    /** Insert soft hyphens in justified paragraphs, with this language's patterns. */
+    hyphenate?: string;
 }
 export declare function createMarkdown(): MarkdownIt;
 export declare function renderMarkdown(source: string, options?: MarkdownOptions): MarkdownResult;

package/dist/markdown/index.js

@@ -7,6 +7,7 @@ import { alerts } from "./alerts.js";
 import { codeBlocks } from "./code-blocks.js";
 import { inlineChildLines } from "./env.js";
 import { highlightCode } from "./highlight.js";
+import { hyphenation } from "./hyphenate.js";
 import { inlineLocalImages } from "./images.js";
 import { keepWithHeading } from "./keep-with-heading.js";
 import { math } from "./math.js";
@@ -32,6 +33,7 @@ export function createMarkdown() {
     md.use(codeBlocks);
     md.use(math);
     md.use(mermaid);
+    md.use(hyphenation);
     return md;
 }
 let shared;
@@ -46,6 +48,7 @@ export function renderMarkdown(source, options = {}) {
         hasMath: false,
         lang: options.lang ?? DEFAULT_LANG,
         hasTocMarker: false,
+        hyphenate: options.hyphenate,
     };
     const tokens = md.parse(source, env);
     let title;

package/dist/options.d.ts

@@ -14,6 +14,8 @@ export type MermaidTheme = (typeof MERMAID_THEMES)[number];
 export declare const MERMAID_FLIPS: readonly ["auto", "never"];
 export type MermaidFlip = (typeof MERMAID_FLIPS)[number];
 export declare const BUILTIN_THEMES: readonly ["light", "dark"];
+export declare const TEXT_FONTS: readonly ["manrope", "inter"];
+export type TextFont = (typeof TEXT_FONTS)[number];
 export declare const DENSITIES: readonly ["normal", "compact"];
 export type Density = (typeof DENSITIES)[number];
 /** Rendering options, merged from defaults < config file < front matter < command line. */
@@ -41,6 +43,10 @@ export interface DocumentOptions {
     mermaidAutofit: boolean;
     /** Whether autofit may turn a flowchart to the other axis (LR ↔ TB) when it reads far better. */
     mermaidFlip: MermaidFlip;
+    /** Justify paragraphs in the PDF (body, quotes, alerts), breaking long words with hyphens. */
+    justify: boolean;
+    /** Typeface of the text: Manrope or Inter (code is always JetBrains Mono). */
+    font: TextFont;
     /** Vertical spacing: "compact" tightens line height, paragraph and heading spacing. */
     density: Density;
     /** Base font size of the text, e.g. "10pt"; when unset, the theme's (10.5pt). */

package/dist/options.js

@@ -7,6 +7,7 @@ export const ORIENTATIONS = ["portrait", "landscape"];
 export const MERMAID_THEMES = ["default", "neutral", "dark", "forest", "base"];
 export const MERMAID_FLIPS = ["auto", "never"];
 export const BUILTIN_THEMES = ["light", "dark"];
+export const TEXT_FONTS = ["manrope", "inter"];
 export const DENSITIES = ["normal", "compact"];
 export const DEFAULT_OPTIONS = {
     pageSize: "Letter",
@@ -17,6 +18,8 @@ export const DEFAULT_OPTIONS = {
     pageNumbers: true,
     mermaidAutofit: true,
     mermaidFlip: "auto",
+    font: "manrope",
+    justify: true,
     density: "normal",
     theme: "light",
     css: [],
@@ -115,6 +118,8 @@ const VALIDATORS = {
     mermaidTheme: oneOf(MERMAID_THEMES),
     mermaidAutofit: bool,
     mermaidFlip: oneOf(MERMAID_FLIPS),
+    font: oneOf(TEXT_FONTS),
+    justify: bool,
     density: oneOf(DENSITIES),
     fontSize,
     theme: (value, describe, baseDir) => {

package/dist/render/browser.d.ts

@@ -21,7 +21,20 @@ export interface PrintOptions {
     footerTemplate?: string;
     /** Let the page load http(s) resources (remote images, stylesheets). Off by default. */
     allowRemote?: boolean;
+    /**
+     * Width of the text column in CSS px. When set, the soft hyphens that do not fall at the end of
+     * a line are removed before printing (see SOFT_HYPHEN_CLEANUP).
+     */
+    softHyphensWidthPx?: number;
 }
+/**
+ * Keep only the soft hyphens (U+00AD) where a line actually breaks. Chrome copies every soft
+ * hyphen into the PDF's text, which splits words for copy, search and text extraction; only the
+ * ones that print as "-" belong there. The page is laid out at the printed column width with
+ * print styles; Chrome breaks lines greedily, so removing break points it did not use leaves
+ * every line as it was. Runs as our own code in the print page, whose scripts are disabled.
+ */
+export declare const SOFT_HYPHEN_CLEANUP = "(width) => {\n  const root = document.documentElement;\n  root.style.width = width + \"px\";\n  try {\n    const range = document.createRange();\n    // The character right after a used soft hyphen also reports the \"-\" drawn at the end of the\n    // previous line: take its last rectangle, and the first one for the character before.\n    const top = (node, i, last) => {\n      range.setStart(node, i);\n      range.setEnd(node, i + 1);\n      const rects = [...range.getClientRects()].filter((r) => r.width > 0);\n      const rect = last ? rects[rects.length - 1] : rects[0];\n      return rect ? rect.top : NaN;\n    };\n    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);\n    const nodes = [];\n    for (let node = walker.nextNode(); node; node = walker.nextNode()) {\n      if (node.data.includes(\"\u00AD\")) nodes.push(node);\n    }\n    let kept = 0;\n    for (const node of nodes) {\n      const text = node.data;\n      let result = \"\";\n      for (let i = 0; i < text.length; i++) {\n        if (text[i] !== \"\u00AD\") {\n          result += text[i];\n        } else if (i > 0 && i < text.length - 1 && top(node, i + 1, true) > top(node, i - 1) + 1) {\n          result += text[i];\n          kept++;\n        }\n      }\n      node.data = result;\n    }\n    return kept;\n  } finally {\n    root.style.width = \"\";\n  }\n}";
 /** One headless browser shared by every step of a conversion (Mermaid, then PDF). */
 export declare class BrowserSession {
     private readonly browser;

package/dist/render/browser.js

@@ -22,6 +22,51 @@ export function shouldRetryWithoutSandbox(error, args, platform = process.platfo
         !args.includes("--no-sandbox") &&
         /no usable sandbox/i.test(String(error?.message ?? error)));
 }
+/**
+ * Keep only the soft hyphens (U+00AD) where a line actually breaks. Chrome copies every soft
+ * hyphen into the PDF's text, which splits words for copy, search and text extraction; only the
+ * ones that print as "-" belong there. The page is laid out at the printed column width with
+ * print styles; Chrome breaks lines greedily, so removing break points it did not use leaves
+ * every line as it was. Runs as our own code in the print page, whose scripts are disabled.
+ */
+export const SOFT_HYPHEN_CLEANUP = `(width) => {
+  const root = document.documentElement;
+  root.style.width = width + "px";
+  try {
+    const range = document.createRange();
+    // The character right after a used soft hyphen also reports the "-" drawn at the end of the
+    // previous line: take its last rectangle, and the first one for the character before.
+    const top = (node, i, last) => {
+      range.setStart(node, i);
+      range.setEnd(node, i + 1);
+      const rects = [...range.getClientRects()].filter((r) => r.width > 0);
+      const rect = last ? rects[rects.length - 1] : rects[0];
+      return rect ? rect.top : NaN;
+    };
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    const nodes = [];
+    for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+      if (node.data.includes("\u00AD")) nodes.push(node);
+    }
+    let kept = 0;
+    for (const node of nodes) {
+      const text = node.data;
+      let result = "";
+      for (let i = 0; i < text.length; i++) {
+        if (text[i] !== "\u00AD") {
+          result += text[i];
+        } else if (i > 0 && i < text.length - 1 && top(node, i + 1, true) > top(node, i - 1) + 1) {
+          result += text[i];
+          kept++;
+        }
+      }
+      node.data = result;
+    }
+    return kept;
+  } finally {
+    root.style.width = "";
+  }
+}`;
 /**
  * Only allow requests the document needs: inline data, plus http(s) when `allowRemote`.
  * file: URLs are always refused, so HTML in a Markdown file cannot pull local files into
@@ -105,6 +150,11 @@ export class BrowserSession {
             await page.setContent(html, { waitUntil: "load" });
             // Make sure every embedded font has loaded before printing.
             await page.evaluate("document.fonts.ready.then(() => undefined)");
+            if (options.softHyphensWidthPx !== undefined) {
+                await page.emulateMediaType("print");
+                await page.setViewport({ width: Math.ceil(options.softHyphensWidthPx), height: 1000 });
+                await page.evaluate(`(${SOFT_HYPHEN_CLEANUP})(${options.softHyphensWidthPx})`);
+            }
             const pdf = await page.pdf({
                 format: options.format ?? "A4",
                 landscape: options.landscape ?? false,

package/dist/render/fonts.d.ts

@@ -1,10 +1,24 @@
-/** Inter Regular alone, for page headers/footers (Chrome renders them apart from the page). */
-export declare function interRegularFontFace(): string;
+import type { TextFont } from "../options.js";
+/**
+ * Static (non-variable) font files are used on purpose: Chromium embeds variable fonts in PDFs
+ * as Type 3 fonts, while static fonts are embedded as proper TrueType fonts.
+ *
+ * Text: Manrope (default) from Fontsource, or Inter 4 from the upstream release (full glyph
+ * set). Manrope covers Latin, Greek, Cyrillic and Vietnamese but has no italics (the browser
+ * slants it) nor arrows and math symbols such as → ✓ ≤: those fall back to Inter, which is
+ * embedded too in its regular and bold weights.
+ * Code: JetBrains Mono from Fontsource (split into unicode-range subsets).
+ */
+export declare const FONT_FAMILIES: Record<TextFont, string>;
+/** CSS font-family list for the text: the chosen font, Inter for missing glyphs, the system's. */
+export declare function fontStack(font: TextFont): string;
 /**
  * Inline a Fontsource stylesheet: the woff2 source becomes a data URI (the legacy woff fallback is
  * dropped) so the document needs no network or file access. `font-display: block` makes the
  * browser wait for the real font instead of printing with a fallback.
  */
 export declare function inlineFontStylesheet(cssKey: string): string;
-/** @font-face rules for every bundled font, with the font files embedded. */
-export declare function fontFaceCss(): string;
+/** @font-face rules for every font a document uses, with the font files embedded. */
+export declare function fontFaceCss(font?: TextFont): string;
+/** The text font's regular weight alone, for page headers/footers (rendered apart from the page). */
+export declare function regularFontFace(font?: TextFont): string;

package/dist/render/fonts.js

@@ -1,11 +1,21 @@
-import { INTER_DIR, INTER_FACES, MONO_STYLESHEETS, readAsset, readTextAsset, woff2References, } from "../assets.js";
+import { INTER_DIR, INTER_FACES, MANROPE_STYLESHEETS, MONO_STYLESHEETS, readAsset, readTextAsset, woff2References, } from "../assets.js";
 /**
  * Static (non-variable) font files are used on purpose: Chromium embeds variable fonts in PDFs
  * as Type 3 fonts, while static fonts are embedded as proper TrueType fonts.
  *
- * Text: Inter 4 (the typeface served by Google Fonts) from the upstream release, full glyph set.
+ * Text: Manrope (default) from Fontsource, or Inter 4 from the upstream release (full glyph
+ * set). Manrope covers Latin, Greek, Cyrillic and Vietnamese but has no italics (the browser
+ * slants it) nor arrows and math symbols such as → ✓ ≤: those fall back to Inter, which is
+ * embedded too in its regular and bold weights.
  * Code: JetBrains Mono from Fontsource (split into unicode-range subsets).
  */
+export const FONT_FAMILIES = { manrope: "Manrope", inter: "Inter" };
+/** CSS font-family list for the text: the chosen font, Inter for missing glyphs, the system's. */
+export function fontStack(font) {
+    return font === "inter"
+        ? `"Inter", system-ui, sans-serif`
+        : `"Manrope", "Inter", system-ui, sans-serif`;
+}
 function woff2DataUri(key) {
     return `data:font/woff2;base64,${readAsset(key).toString("base64")}`;
 }
@@ -18,12 +28,6 @@ function interFace({ weight, style, file }) {
   src: url(${woff2DataUri(`${INTER_DIR}/${file}`)}) format("woff2");
 }`;
 }
-let regularFace;
-/** Inter Regular alone, for page headers/footers (Chrome renders them apart from the page). */
-export function interRegularFontFace() {
-    regularFace ??= interFace(INTER_FACES[0]);
-    return regularFace;
-}
 /**
  * Inline a Fontsource stylesheet: the woff2 source becomes a data URI (the legacy woff fallback is
  * dropped) so the document needs no network or file access. `font-display: block` makes the
@@ -38,10 +42,39 @@ export function inlineFontStylesheet(cssKey) {
         .replace(/,\s*url\([^)]+\.woff\)\s*format\(['"]woff['"]\)/g, "")
         .replace(/url\((['"]?)([^)'"]+\.woff2)\1\)/g, () => `url(${woff2DataUri(fonts[index++])})`);
 }
-let cached;
-/** @font-face rules for every bundled font, with the font files embedded. */
-export function fontFaceCss() {
-    cached ??= [...INTER_FACES.map(interFace), ...MONO_STYLESHEETS.map(inlineFontStylesheet)].join("\n");
-    return cached;
+const interUpright = (weight) => INTER_FACES.find((face) => face.weight === weight && face.style === "normal");
+/** @font-face rules for the text font and its fallback, with the font files embedded. */
+function textFaces(font) {
+    if (font === "inter")
+        return INTER_FACES.map(interFace);
+    return [
+        ...MANROPE_STYLESHEETS.map(inlineFontStylesheet),
+        // Fallback for glyphs Manrope lacks; 600 text takes the nearest heavier face, 700.
+        interFace(interUpright(400)),
+        interFace(interUpright(700)),
+    ];
+}
+const cached = new Map();
+/** @font-face rules for every font a document uses, with the font files embedded. */
+export function fontFaceCss(font = "manrope") {
+    let css = cached.get(font);
+    if (css === undefined) {
+        css = [...textFaces(font), ...MONO_STYLESHEETS.map(inlineFontStylesheet)].join("\n");
+        cached.set(font, css);
+    }
+    return css;
+}
+const regularFaces = new Map();
+/** The text font's regular weight alone, for page headers/footers (rendered apart from the page). */
+export function regularFontFace(font = "manrope") {
+    let css = regularFaces.get(font);
+    if (css === undefined) {
+        css =
+            font === "inter"
+                ? interFace(interUpright(400))
+                : [inlineFontStylesheet(MANROPE_STYLESHEETS[0]), interFace(interUpright(400))].join("\n");
+        regularFaces.set(font, css);
+    }
+    return css;
 }
 //# sourceMappingURL=fonts.js.map

package/dist/render/header-footer.d.ts

@@ -1,3 +1,4 @@
+import type { TextFont } from "../options.js";
 /**
  * Header/footer text with placeholders, in up to three columns separated by `|`:
  *
@@ -13,10 +14,10 @@ export interface HeaderFooterValues {
 }
 /**
  * Chrome header/footer template. Chrome renders it apart from the page, so it carries its own
- * styles and its own copy of Inter.
+ * styles and its own copy of the text font.
  */
 export declare function headerFooterTemplate(spec: string | undefined, values: HeaderFooterValues, horizontalMargin: {
     left: string;
     right: string;
-}): string;
+}, font?: TextFont): string;
 export declare const DEFAULT_FOOTER = "{page} / {pages}";

package/dist/render/header-footer.js

@@ -1,5 +1,5 @@
 import { escapeHtml } from "../html.js";
-import { interRegularFontFace } from "./fonts.js";
+import { fontStack, regularFontFace } from "./fonts.js";
 const CHROME_CLASSES = { page: "pageNumber", pages: "totalPages" };
 function renderText(text, values) {
     return escapeHtml(text.trim()).replace(/\{(\w+)\}/g, (match, name) => {
@@ -21,15 +21,15 @@ function columns(spec) {
 }
 /**
  * Chrome header/footer template. Chrome renders it apart from the page, so it carries its own
- * styles and its own copy of Inter.
+ * styles and its own copy of the text font.
  */
-export function headerFooterTemplate(spec, values, horizontalMargin) {
+export function headerFooterTemplate(spec, values, horizontalMargin, font = "manrope") {
     if (!spec)
         return "<span></span>";
     const [left, center, right] = columns(spec).map((c) => renderText(c, values));
-    return `<style>${interRegularFontFace()}</style>
+    return `<style>${regularFontFace(font)}</style>
 <div style="box-sizing: border-box; width: 100%; display: flex; padding: 0 ${horizontalMargin.right} 0 ${horizontalMargin.left};
-  font-family: Inter, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; font-size: 8pt; color: #59636e;">
+  font-family: ${fontStack(font).replaceAll('"', "'")}; font-size: 8pt; color: #59636e;">
   <span style="flex: 1; text-align: left;">${left}</span>
   <span style="flex: 1; text-align: center;">${center}</span>
   <span style="flex: 1; text-align: right;">${right}</span>

package/dist/render/mermaid.d.ts

@@ -1,6 +1,6 @@
 import type { Diagnostic } from "../diagnostics.js";
 import type { MermaidBlock } from "../markdown/env.js";
-import type { MermaidFlip, MermaidTheme } from "../options.js";
+import type { MermaidFlip, MermaidTheme, TextFont } from "../options.js";
 import type { BrowserSession } from "./browser.js";
 export { MERMAID_THEMES, type MermaidTheme } from "../options.js";
 /** How autofit laid out a flowchart (see render/mermaid-fit.ts). */
@@ -37,6 +37,8 @@ export interface MermaidRenderOptions {
     /** Search label wrapping widths (and, with `flip`, the other axis) for each flowchart. */
     autofit?: boolean;
     flip?: MermaidFlip;
+    /** Text font of the document, used for diagram labels too. */
+    font?: TextFont;
 }
 /**
  * Room kept for a heading printed together with the diagram below it (see keep-with-heading in

package/dist/render/mermaid.js

@@ -1,6 +1,6 @@
 import { MERMAID_JS, readTextAsset } from "../assets.js";
 import { mermaidPlaceholder } from "../markdown/mermaid.js";
-import { fontFaceCss } from "./fonts.js";
+import { FONT_FAMILIES, fontFaceCss, fontStack } from "./fonts.js";
 import { escapeHtml } from "../html.js";
 import { authorConfigured, candidate, chooseCandidate, flipWorthTrying, flippedDirection, flowchartHeader, withDirection, WRAPPING_WIDTHS, wrapsExhausted, } from "./mermaid-fit.js";
 export { MERMAID_THEMES } from "../options.js";
@@ -14,15 +14,16 @@ const DEFAULT_FONT_PX = 14;
  */
 export const HEADING_ALLOWANCE_EM = 5;
 let mermaidJs;
-function mermaidConfig(theme, fontPx, wrap) {
+function mermaidConfig(theme, font, fontPx, wrap) {
+    const fontFamily = fontStack(font);
     return {
         startOnLoad: false,
         securityLevel: "strict",
         theme,
-        fontFamily: "Inter, sans-serif",
+        fontFamily,
         // Sequence diagrams take their text sizes from here, the others from themeVariables.
         fontSize: fontPx,
-        themeVariables: { fontFamily: "Inter, sans-serif", fontSize: `${fontPx}px` },
+        themeVariables: { fontFamily, fontSize: `${fontPx}px` },
         htmlLabels: true,
         // Actors only at the top of sequence diagrams: repeating them below costs height.
         sequence: { mirrorActors: false },
@@ -35,20 +36,21 @@ function mermaidConfig(theme, fontPx, wrap) {
  * flowcharts are rendered in several layouts and the one whose text prints largest is kept.
  */
 export async function renderMermaid(session, blocks, options = {}) {
-    const { theme = "neutral", widthPx = DEFAULT_WIDTH_PX, fontPx = DEFAULT_FONT_PX, pageHeightPx = Infinity, autofit = true, flip = "auto", } = options;
+    const { theme = "neutral", widthPx = DEFAULT_WIDTH_PX, fontPx = DEFAULT_FONT_PX, pageHeightPx = Infinity, autofit = true, flip = "auto", font = "manrope", } = options;
+    const family = FONT_FAMILIES[font];
     mermaidJs ??= readTextAsset(MERMAID_JS);
     const page = await session.newPage();
     try {
-        await page.setContent(`<!doctype html><html><head><meta charset="utf-8"><style>${fontFaceCss()}
-body { margin: 0; width: ${widthPx}px; font-family: "Inter", sans-serif; }</style>
+        await page.setContent(`<!doctype html><html><head><meta charset="utf-8"><style>${fontFaceCss(font)}
+body { margin: 0; width: ${widthPx}px; font-family: ${fontStack(font)}; }</style>
 </head><body></body></html>`);
         await page.evaluate(mermaidJs);
-        await page.evaluate(async () => {
+        await page.evaluate(async (family) => {
             // Runs in the browser. The project is compiled without DOM types, hence PageGlobals.
             const { document } = globalThis;
             // Load the font weights Mermaid uses before it measures any text.
-            await Promise.all(["400", "600", "700"].map((w) => document.fonts.load(`${w} 16px Inter`)));
-        });
+            await Promise.all(["400", "600", "700"].map((w) => document.fonts.load(`${w} 16px "${family}"`)));
+        }, family);
         const render = (source, id, wrap) => page.evaluate(async (source, id, config) => {
             const { mermaid } = globalThis;
             // Each render sets the whole configuration, so one layout never leaks into the next.
@@ -59,7 +61,7 @@ body { margin: 0; width: ${widthPx}px; font-family: "Inter", sans-serif; }</styl
             catch (error) {
                 return { error: String(error?.message ?? error) };
             }
-        }, source, id, mermaidConfig(theme, fontPx, wrap));
+        }, source, id, mermaidConfig(theme, font, fontPx, wrap));
         const results = [];
         for (const [i, block] of blocks.entries()) {
             const id = `mermaid-${i + 1}`;

package/dist/render/page.d.ts

@@ -1,6 +1,11 @@
 import type { PageSize } from "../options.js";
 export declare function lengthToPx(length: string): number;
-/** Width of the text column in CSS pixels, so diagrams are laid out at their printed size. */
+/** Exact width of the text column in CSS pixels, as Chrome prints it. */
+export declare function textWidthPx(pageSize: PageSize, landscape: boolean, margin: {
+    left: string;
+    right: string;
+}): number;
+/** Width of the text column in whole CSS pixels, so diagrams are laid out at their printed size. */
 export declare function contentWidthPx(pageSize: PageSize, landscape: boolean, margin: {
     left: string;
     right: string;

package/dist/render/page.js

@@ -14,11 +14,15 @@ export function lengthToPx(length) {
         throw new Error(`invalid length: ${length}`);
     return Number(match[1]) * PX_PER_UNIT[match[2]];
 }
-/** Width of the text column in CSS pixels, so diagrams are laid out at their printed size. */
-export function contentWidthPx(pageSize, landscape, margin) {
+/** Exact width of the text column in CSS pixels, as Chrome prints it. */
+export function textWidthPx(pageSize, landscape, margin) {
     const [width, height] = PAPER_MM[pageSize];
     const paperPx = ((landscape ? height : width) * 96) / 25.4;
-    return Math.round(paperPx - lengthToPx(margin.left) - lengthToPx(margin.right));
+    return paperPx - lengthToPx(margin.left) - lengthToPx(margin.right);
+}
+/** Width of the text column in whole CSS pixels, so diagrams are laid out at their printed size. */
+export function contentWidthPx(pageSize, landscape, margin) {
+    return Math.round(textWidthPx(pageSize, landscape, margin));
 }
 /** Height of the text area in CSS pixels: the paper minus the top and bottom margins. */
 export function contentHeightPx(pageSize, landscape, margin) {

package/dist/render/template.d.ts

@@ -1,4 +1,5 @@
 import { escapeHtml } from "../html.js";
+import type { TextFont } from "../options.js";
 export { escapeHtml };
 /** Stylesheets of a built-in theme ("light" or "dark"). */
 export declare function builtinThemeCss(theme: "light" | "dark"): string[];
@@ -17,6 +18,8 @@ export interface DocumentParts {
     showTitle?: boolean;
     /** Theme stylesheet contents. Defaults to the built-in light theme. */
     themeCss?: string[];
+    /** Text font to embed. Defaults to Manrope. */
+    font?: TextFont;
     /** Layout stylesheets (density, font size, page height), applied after the theme. */
     layoutCss?: string[];
     /** Extra stylesheet contents, applied after the theme and layout. */

package/dist/render/template.js

@@ -38,7 +38,7 @@ export function buildHtmlDocument(parts) {
     const { title, body, math = false, lang, author, layoutCss = [], extraCss = [] } = parts;
     const themeCss = parts.themeCss ?? builtinThemeCss("light");
     const styles = [
-        fontFaceCss(),
+        fontFaceCss(parts.font),
         ...(math ? [katexCss()] : []),
         ...themeCss,
         ...layoutCss,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@imontene/mdrender",
-  "version": "2.2.0",
-  "description": "Command-line app for Windows and Linux that renders Markdown — with LaTeX equations and Mermaid diagrams — to PDF and HTML using the Inter typeface",
+  "version": "2.4.0",
+  "description": "Command-line app for Windows and Linux that renders Markdown — with LaTeX equations and Mermaid diagrams — to PDF and HTML set in Manrope or Inter",
   "keywords": [
     "markdown",
     "pdf",
@@ -11,6 +11,7 @@
     "latex",
     "cli",
     "inter",
+    "manrope",
     "converter"
   ],
   "homepage": "https://github.com/imontene/MD_reder#readme",
@@ -65,10 +66,12 @@
   },
   "dependencies": {
     "@fontsource/jetbrains-mono": "^5.3.0",
+    "@fontsource/manrope": "^5.3.0",
     "@puppeteer/browsers": "^3.2.3",
     "chokidar": "^5.0.0",
     "commander": "^15.0.0",
     "highlight.js": "^11.12.0",
+    "hyphen": "^1.14.1",
     "inter-ui": "^4.1.1",
     "katex": "^0.19.0",
     "markdown-it": "^15.0.2",
@@ -81,6 +84,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/hyphen": "^1.14.0",
     "@types/node": "^22.20.5",
     "@vitest/coverage-v8": "^5.0.3",
     "esbuild": "^0.28.2",