@phuthuycoding/markcv 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-09-06
+
+### Fixed
+
+- HTML comments were printed into the PDF instead of being dropped. With
+  markdown-it's `html: false`, comments are escaped into visible text rather than
+  ignored, so a file carrying `<!-- markcv:no-build -->` rendered that marker at
+  the top of the page. Comments are metadata for tooling, never content, and are
+  now stripped before rendering.
+
 ## [0.1.3] - 2026-09-06
 
 ### Changed
@@ -73,7 +83,8 @@ First release.
 - Two ATS-safe themes: `classic` and `compact`.
 - Example CVs in `examples/`, with and without a portrait photo.
 
-[Unreleased]: https://github.com/phuthuycoding/markcv/compare/v0.1.3...HEAD
+[Unreleased]: https://github.com/phuthuycoding/markcv/compare/v0.1.4...HEAD
+[0.1.4]: https://github.com/phuthuycoding/markcv/compare/v0.1.3...v0.1.4
 [0.1.3]: https://github.com/phuthuycoding/markcv/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/phuthuycoding/markcv/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/phuthuycoding/markcv/compare/v0.1.0...v0.1.1

package/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/phuthuycoding/markcv/actions/workflows/ci.yml/badge.svg)](https://github.com/phuthuycoding/markcv/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@phuthuycoding/markcv.svg)](https://www.npmjs.com/package/@phuthuycoding/markcv)
+[![docs](https://img.shields.io/badge/docs-markcv-c96442)](https://phuthuycoding.github.io/markcv/)
 
 <p align="center">
   <img src="docs/screenshots/engineering-lead.png" width="640" alt="Two-page ATS-safe resume PDF generated from Markdown by markcv">
@@ -245,6 +246,11 @@ markcv exists for the part that comes after the rendering works:
 | **Job-description match** | — | missing requirements, SKILLS-only claims, unrelated bullets |
 | **Usable by an AI agent** | — | MCP server, structured JSON |
 
+## Author
+
+Built by [Ta Manh Quyen](https://quyentm.dev) — a staff engineer who got tired of guessing
+why a CV spilled onto a third page. More writing at [quyentm.dev](https://quyentm.dev).
+
 ## License
 
 MIT

package/dist/core/markdown.d.ts

@@ -1,5 +1,5 @@
 import type { CvDoc } from "../types.js";
-export declare function parseCv(raw: string): CvDoc;
+export declare function parseCv(input: string): CvDoc;
 /**
  * Markdown -> page body HTML.
  * The header (name + contact lines) is wrapped in .header so the portrait can be

package/dist/core/markdown.js

@@ -1,10 +1,19 @@
 import MarkdownIt from "markdown-it";
 const md = new MarkdownIt({ html: false, linkify: false, typographer: false });
+/**
+ * HTML comments carry metadata for tools (markcv:no-build and friends), never
+ * content. With `html: false` markdown-it escapes them into visible text rather
+ * than dropping them, so strip them before rendering.
+ */
+function stripComments(raw) {
+    return raw.replace(/<!--[\s\S]*?-->/g, "");
+}
 /** A header contact line: `**Label:** value` (no `|`, unlike a job-title line). */
 const CONTACT_RE = /^<p><strong>[^<]+:<\/strong>[^|]*<\/p>$/;
 /** A job-title line: `**Job Title** | 2020 - 2021`. */
 const META_RE = /^<p><strong>.*\|.*<\/p>$/;
-export function parseCv(raw) {
+export function parseCv(input) {
+    const raw = stripComments(input);
     const lines = raw.split("\n");
     const sections = [];
     lines.forEach((line, i) => {
@@ -23,7 +32,7 @@ export function parseCv(raw) {
  * be laid out as one block.
  */
 export function renderBody(raw, photoHtml) {
-    const html = md.render(raw);
+    const html = md.render(stripComments(raw));
     const blocks = html.split("\n").filter((l) => l.trim() !== "");
     const out = [];
     let headerOpen = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phuthuycoding/markcv",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Markdown resume builder that lints your CV and explains why it will not fit two pages. ATS-safe PDF, job-description tailoring, CLI + MCP server for AI agents.",
   "type": "module",
   "bin": {