尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

14 天 Markdown 实战入门(VS Code 版)-- 第 13 章:导出与发布:HTML / PDF / Word、静态站点、GitHub

14 天 Markdown 实战入门(VS Code 版)-- 第 13 章:导出与发布:HTML / PDF / Word、静态站点、GitHub 系列名:《从 0 到 1:14 天 Markdown 实战入门(VS Code 版)》更新节奏:每天 1 章,共 14 章本章难度:⭐⭐⭐☆☆本章关键词:导出、PDF、HTML、Word、Pandoc、GitHub、静态站点、发布1. 本章导读前面十二章,我们一直在“写” Markdown。但写完之后呢?Markdown 只是源文件,最终你要把它变成可交付的成果:发给同事的 PDF 文档。提交给客户的 Word 文件。发布到 GitHub 的 README。部署到网上的博客文章。导出为 HTML 的在线文档。这一章我们要解决 Markdown 的“最后一公里”:导出与发布。你会学到:如何把 Markdown 导出为 HTML。如何打印为 PDF。如何用 Markdown Preview Enhanced 导出多种格式。如何用 Pandoc 转换文档。如何写 GitHub README。如何把 Markdown 发布到静态博客。一个完整的导出与发布流程。2. 学习目标完成本章后,你应当能够:使用 VS Code 导出 HTML。使用浏览器打印为 PDF。使用 Markdown Preview Enhanced 导出 PDF、HTML、PNG、EPUB。了解 Pandoc 的基本用法。写规范的 GitHub README。理解静态站点生成器的工作流程。把 Markdown 发布到 GitHub Pages。完成从写作到发布的完整流程。识别并解决导出中的常见问题。3. 理论讲解3.1 导出格式概览Markdown 可以导出为多种格式:格式用途工具HTML网页、在线文档VS Code、MPE、PandocPDF打印、正式文档浏览器、MPE、PandocWord协作、交付Pandoc、TyporaPNG图片分享MPE、Mermaid LiveEPUB电子书Pandoc、MPEPPT演示Pandoc、MarpMarkdown源文件本身选择建议:发给同事:PDF 或 Word。发布网站:HTML 或静态站点。开源项目:GitHub README。电子书:EPUB 或 PDF。演示:Marp 或 PPT。3.2 VS Code 内置导出 HTMLVS Code 内置预览可以导出 HTML。步骤:打开 Markdown 文件。打开预览:Ctrl + Shift + V/Cmd + Shift + V。在预览中右键,选择“复制为 HTML”或“打印”。或使用命令面板:Markdown: Print Current Document to HTML注意:内置导出功能有限。样式比较简单。复杂公式、Mermaid、代码高亮可能丢失。适合简单文档。3.3 浏览器打印为 PDF最简单的方式:打开 Markdown 预览。在预览中右键,选择“在浏览器中打开”。浏览器中按Ctrl + P/Cmd + P。选择“另存为 PDF”。调整页面设置。优点:不需要额外工具。样式相对可控。支持大部分 Markdown 语法。缺点:分页不精确。代码块可能被截断。公式和 Mermaid 可能丢失。3.4 Markdown Preview Enhanced 导出Markdown Preview Enhanced 是导出功能最强大的插件之一。支持导出:HTMLPDFPNGJPEGEPUBPugPandoc电子书步骤:打开增强预览:Markdown Preview Enhanced: Open Preview在预览中右键,选择“Export”。选择目标格式。导出 PDF:Markdown Preview Enhanced: Chrome (Puppeteer) - PDF导出 HTML:Markdown Preview Enhanced: HTML - HTML导出 PNG:Markdown Preview Enhanced: Chrome (Puppeteer) - PNG3.5 配置 Markdown Preview Enhanced 导出导出 PDF 配置示例:{"markdown-preview-enhanced.chromeExecutablePath":"","markdown-preview-enhanced.puppeteer":{"args":["--no-sandbox"]},"markdown-preview-enhanced.pdf":{"format":"A4","printBackgro
返回列表