嵌入YouTube视频

VitePress 进阶：如何优雅地在文章中嵌入 YouTube 视频？(组件封装与避坑指南)

我的网站是用 vitepress 搭建的，在撰写技术文档时，我们经常需要插入 YouTube 视频教程。很多站长习惯直接复制 YouTube 提供的代码粘贴到 Markdown 里。虽然能用，但缺点很明显：代码丑陋：文章里充斥着一大段 HTML 代码，难以维护。手机端体验差…
<script type="text/javascript" src="https://www.blogger.com/static/v1/widgets/1531375970-widgets.js"></script>
<script type='text/javascript'>
window['__wavt'] = 'AEUoTZo2R7jwiBUFZGF2nMQpk4rk:1783984470351';_WidgetManager._Init('//www.blogger.com/rearrange?blogID\x3d862577558267434976','//www.kejiciwei.com/search/label/%E5%B5%8C%E5%85%A5YouTube%E8%A7%86%E9%A2%91','862577558267434976');
_WidgetManager._SetDataContext([{'name': 'blog', 'data': {'blogId': '862577558267434976', 'title': '\u79d1\u6280\u523a\u732c', 'url': 'https://www.kejiciwei.com/search/label/%E5%B5%8C%E5%85%A5YouTube%E8%A7%86%E9%A2%91', 'canonicalUrl': 'https://www.kejiciwei.com/search/label/%E5%B5%8C%E5%85%A5YouTube%E8%A7%86%E9%A2%91', 'homepageUrl': 'https://www.kejiciwei.com/', 'searchUrl': 'https://www.kejiciwei.com/search', 'canonicalHomepageUrl': 'https://www.kejiciwei.com/', 'blogspotFaviconUrl': 'https://www.kejiciwei.com/favicon.ico', 'bloggerUrl': 'https://www.blogger.com', 'hasCustomDomain': true, 'httpsEnabled': true, 'enabledCommentProfileImages': true, 'gPlusViewType': 'FILTERED_POSTMOD', 'adultContent': false, 'analyticsAccountNumber': 'G-KGY2LPVGQ3', 'analytics4': true, 'encoding': 'UTF-8', 'locale': 'zh-CN', 'localeUnderscoreDelimited': 'zh_cn', 'languageDirection': 'ltr', 'isPrivate': false, 'isMobile': false, 'isMobileRequest': false, 'mobileClass': '', 'isPrivateBlog': false, 'isDynamicViewsAvailable': false, 'feedLinks': '', 'meTag': '', 'adsenseClientId': 'ca-pub-1683234937128959', 'adsenseHostId': 'ca-host-pub-1556223355139109', 'adsenseHasAds': true, 'adsenseAutoAds': true, 'boqCommentIframeForm': true, 'loginRedirectParam': '', 'isGoogleEverywhereLinkTooltipEnabled': true, 'view': '', 'dynamicViewsCommentsSrc': '//www.blogblog.com/dynamicviews/4224c15c4e7c9321/js/comments.js', 'dynamicViewsScriptSrc': '//www.blogblog.com/dynamicviews/7b5894e2a0a8526d', 'plusOneApiSrc': 'https://apis.google.com/js/platform.js', 'disableGComments': true, 'interstitialAccepted': false, 'sharing': {'platforms': [{'name': '\u83b7\u53d6\u94fe\u63a5', 'key': 'link', 'shareMessage': '\u83b7\u53d6\u94fe\u63a5', 'target': ''}, {'name': 'Facebook', 'key': 'facebook', 'shareMessage': '\u5206\u4eab\u5230 Facebook', 'target': 'facebook'}, {'name': 'BlogThis!', 'key': 'blogThis', 'shareMessage': 'BlogThis!', 'target': 'blog'}, {'name': 'X', 'key': 'twitter', 'shareMessage': '\u5206\u4eab\u5230 X', 'target': 'twitter'}, {'name': 'Pinterest', 'key': 'pinterest', 'shareMessage': '\u5206\u4eab\u5230 Pinterest', 'target': 'pinterest'}, {'name': '\u7535\u5b50\u90ae\u4ef6', 'key': 'email', 'shareMessage': '\u7535\u5b50\u90ae\u4ef6', 'target': 'email'}], 'disableGooglePlus': true, 'googlePlusShareButtonWidth': 0, 'googlePlusBootstrap': '\x3cscript type\x3d\x22text/javascript\x22\x3ewindow.___gcfg \x3d {\x27lang\x27: \x27zh_CN\x27};\x3c/script\x3e'}, 'hasCustomJumpLinkMessage': false, 'jumpLinkMessage': '\u9605\u8bfb\u5168\u6587', 'pageType': 'index', 'searchLabel': '\u5d4c\u5165YouTube\u89c6\u9891', 'pageName': '\u5d4c\u5165YouTube\u89c6\u9891', 'pageTitle': '\u79d1\u6280\u523a\u732c: \u5d4c\u5165YouTube\u89c6\u9891', 'metaDescription': ''}}, {'name': 'features', 'data': {}}, {'name': 'messages', 'data': {'edit': '\u4fee\u6539', 'linkCopiedToClipboard': '\u94fe\u63a5\u5df2\u590d\u5236\u5230\u526a\u8d34\u677f\uff01', 'ok': '\u786e\u5b9a', 'postLink': '\u535a\u6587\u94fe\u63a5'}}, {'name': 'template', 'data': {'name': 'custom', 'localizedName': '\u81ea\u5b9a\u4e49', 'isResponsive': true, 'isAlternateRendering': false, 'isCustom': true}}, {'name': 'view', 'data': {'classic': {'name': 'classic', 'url': '?view\x3dclassic'}, 'flipcard': {'name': 'flipcard', 'url': '?view\x3dflipcard'}, 'magazine': {'name': 'magazine', 'url': '?view\x3dmagazine'}, 'mosaic': {'name': 'mosaic', 'url': '?view\x3dmosaic'}, 'sidebar': {'name': 'sidebar', 'url': '?view\x3dsidebar'}, 'snapshot': {'name': 'snapshot', 'url': '?view\x3dsnapshot'}, 'timeslide': {'name': 'timeslide', 'url': '?view\x3dtimeslide'}, 'isMobile': false, 'title': '\u79d1\u6280\u523a\u732c', 'description': '', 'url': 'https://www.kejiciwei.com/search/label/%E5%B5%8C%E5%85%A5YouTube%E8%A7%86%E9%A2%91', 'type': 'feed', 'isSingleItem': false, 'isMultipleItems': true, 'isError': false, 'isPage': false, 'isPost': false, 'isHomepage': false, 'isArchive': false, 'isSearch': true, 'isLabelSearch': true, 'search': {'label': '\u5d4c\u5165YouTube\u89c6\u9891', 'resultsMessage': '\u76ee\u524d\u663e\u793a\u7684\u662f\u6807\u7b7e\u4e3a\u201c\u5d4c\u5165YouTube\u89c6\u9891\u201d\u7684\u535a\u6587', 'resultsMessageHtml': '\u76ee\u524d\u663e\u793a\u7684\u662f\u6807\u7b7e\u4e3a\u201c\x3cspan class\x3d\x27search-label\x27\x3e\u5d4c\u5165YouTube\u89c6\u9891\x3c/span\x3e\u201d\u7684\u535a\u6587'}}}, {'name': 'widgets', 'data': [{'title': '\u79d1\u6280\u523a\u732c (\u6807\u9898)', 'type': 'Header', 'sectionId': 'sec_Header_Title', 'id': 'Header01'}, {'title': '\u641c\u7d22', 'type': 'BlogSearch', 'sectionId': 'sec_Header_Search', 'id': 'BlogSearch01'}, {'title': 'Header Icon', 'type': 'TextList', 'sectionId': 'sec_Header_Icon', 'id': 'TextList01'}, {'title': 'Bookmark Posts', 'type': 'LinkList', 'sectionId': 'sec_Header_Icon', 'id': 'LinkList02'}, {'title': 'Translate', 'type': 'LinkList', 'sectionId': 'sec_Header_Icon', 'id': 'LinkList03'}, {'title': 'Additional Links', 'type': 'PageList', 'sectionId': 'sec_Nav_Widgets_2', 'id': 'PageList02'}, {'title': 'Social Links', 'type': 'LinkList', 'sectionId': 'sec_Nav_Widgets_2', 'id': 'LinkList04'}, {'title': 'Tabbed Menu', 'type': 'LinkList', 'sectionId': 'sec_Under_Header', 'id': 'LinkList05'}, {'title': '\u516c\u544a\uff1aNotification', 'type': 'LinkList', 'sectionId': 'sec_Under_Header', 'id': 'LinkList06'}, {'title': 'Labels Description', 'type': 'LinkList', 'sectionId': 'sec_Under_Header', 'id': 'LinkList07'}, {'title': '', 'type': 'HTML', 'sectionId': 'sec_Horizontal-Ad', 'id': 'HTML1'}, {'title': 'Pinned Post', 'type': 'FeaturedPost', 'sectionId': 'sec_Top_Widgets', 'id': 'FeaturedPost01', 'postId': '5286443108318109331'}, {'title': '\u535a\u6587', 'type': 'Blog', 'sectionId': 'sec_Main_Widgets', 'id': 'Blog01', 'posts': [{'id': '2645145059214754847', 'title': 'VitePress \u8fdb\u9636\uff1a\u5982\u4f55\u4f18\u96c5\u5730\u5728\u6587\u7ae0\u4e2d\u5d4c\u5165 YouTube \u89c6\u9891\uff1f(\u7ec4\u4ef6\u5c01\u88c5\u4e0e\u907f\u5751\u6307\u5357)', 'featuredImage': 'https://blogger.googleusercontent.com/img/a/AVvXsEhsgVzkUjhRlfcSH5AAz4RYfEX-mK3Ns1ph6AiPPjIWQOmVZdXf8IUJMiOfYvETFQjCzb4VKJjdSE_t2fAcKkOkfenWfDgkZn1nLao1D9pF7NQI-fnyMxWZ5OXqu1050s-JUm33cxEqDA9klMHj5UGedAnpNyHcFdeFsthhLEouMfR3FwpMwOODFwgBV-3b\x3dw640-h364', 'showInlineAds': false}], 'footerBylines': [{'regionName': 'footer1', 'items': [{'name': 'author', 'label': 'Published by'}, {'name': 'timestamp', 'label': 'On'}, {'name': 'comments', 'label': 'Comment'}, {'name': 'icons', 'label': ''}, {'name': 'share', 'label': ''}]}, {'regionName': 'footer2', 'items': [{'name': 'labels', 'label': 'in'}]}, {'regionName': 'footer3', 'items': [{'name': 'location', 'label': '\u5730\u70b9:'}]}], 'allBylineItems': [{'name': 'author', 'label': 'Published by'}, {'name': 'timestamp', 'label': 'On'}, {'name': 'comments', 'label': 'Comment'}, {'name': 'icons', 'label': ''}, {'name': 'share', 'label': ''}, {'name': 'labels', 'label': 'in'}, {'name': 'location', 'label': '\u5730\u70b9:'}]}, {'title': 'Categorized Posts', 'type': 'LinkList', 'sectionId': 'sec_Main_Widgets', 'id': 'LinkList08'}, {'title': 'Table of contents', 'type': 'HTML', 'sectionId': 'sec_Main_Widgets', 'id': 'HTML11'}, {'title': '', 'type': 'Image', 'sectionId': 'sec_Side_Widgets', 'id': 'Image1'}, {'title': 'Popular Posts', 'type': 'PopularPosts', 'sectionId': 'sec_Side_Widgets', 'id': 'PopularPosts01', 'posts': [{'title': 'Apple\u8ba2\u9605\u9000\u6b3e\u7ec8\u6781\u6307\u5357\uff1a\u4eceApp Store\u5230iCloud\uff0c\u4e00\u6587\u641e\u5b9a\u6240\u6709\u82f9\u679c\u9000\u6b3e\u95ee\u9898\uff082025\u6700\u65b0\uff09', 'id': 5547678303592747614}, {'title': '\u82f9\u679cApp\u5185\u8d2d\u9000\u6b3e\u5931\u8d25\uff1f\u522b\u6025\uff0c\u8bd5\u8bd5\u8fd93\u4e2a\u7533\u8bc9\u6280\u5de7\uff0c\u5927\u5e45\u63d0\u9ad8\u6210\u529f\u7387\u3002', 'id': 4152335796626235161}, {'title': '\u5982\u4f55\u5728 iPhone 16 \u76f8\u673a\u4e2d\u8c03\u6574\u548c\u9501\u5b9a\u7126\u70b9\u4e0e\u66dd\u5149\uff0ciPhone\u76f8\u673a\u7684\u4f7f\u7528\u6280\u5de7\u6559\u7a0b', 'id': 7465414026225062620}, {'title': '\u5982\u4f55\u901a\u8fc7\u5e8f\u5217\u53f7\u67e5\u770b MacBook Pro, Air, iMac \u548c Mac mini \u7684\u578b\u53f7\uff1a\u6240\u6709 Mac \u673a\u578b\u6309\u5e74\u4efd\u5212\u5206', 'id': 3703714672026525534}, {'title': '\u65e0\u9700\u5355\u53cd\uff01\u5982\u4f55\u5728iPhone\u4e0a\u62cd\u6444\u957f\u66dd\u5149\uff08\u6162\u95e8\uff09\u7167\u7247\uff1a\u4e24\u79cd\u65b9\u6cd5\uff08\u9644\u8be6\u7ec6\u6559\u7a0b\uff09', 'id': 666359232834870869}]}, {'title': 'Labels', 'type': 'Label', 'sectionId': 'sec_Side_Widgets', 'id': 'Label01'}, {'title': 'Take me back', 'type': 'HTML', 'sectionId': 'sec_Error_404', 'id': 'HTML404'}, {'title': '\u79d1\u6280\u523a\u732c', 'type': 'Image', 'sectionId': 'sec_Footer_Organization', 'id': 'Image21'}, {'title': 'Social Media Links', 'type': 'LinkList', 'sectionId': 'sec_Footer_Organization', 'id': 'LinkList21'}, {'title': '', 'type': 'LinkList', 'sectionId': 'sec_Footer_Widgets', 'id': 'LinkList24'}, {'title': '', 'type': 'LinkList', 'sectionId': 'sec_Footer_Widgets', 'id': 'LinkList25'}, {'title': 'Mobile Menu', 'type': 'TextList', 'sectionId': 'sec_Mobile_Menu', 'id': 'TextList99'}, {'title': 'Labels', 'type': 'Label', 'sectionId': 'sec_Theme_Hidden', 'id': 'Label41'}, {'title': '\u8054\u7cfb\u4eba\u8868\u5355', 'type': 'ContactForm', 'sectionId': 'sec_Theme_Hidden', 'id': 'ContactForm41'}, {'title': 'Pageviews last month', 'type': 'Stats', 'sectionId': 'sec_Theme_Hidden', 'id': 'Stats41'}, {'title': 'Cookie Consent [NoTitle]', 'type': 'LinkList', 'sectionId': 'sec_Addon_Widgets', 'id': 'LinkList63'}, {'title': 'Image Uploader', 'type': 'Image', 'sectionId': 'sec_Addon_Widgets', 'id': 'Image61'}]}]);
_WidgetManager._RegisterWidget('_HeaderView', new _WidgetInfo('Header01', 'sec_Header_Title', document.getElementById('Header01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_BlogSearchView', new _WidgetInfo('BlogSearch01', 'sec_Header_Search', document.getElementById('BlogSearch01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_TextListView', new _WidgetInfo('TextList01', 'sec_Header_Icon', document.getElementById('TextList01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList02', 'sec_Header_Icon', document.getElementById('LinkList02'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList03', 'sec_Header_Icon', document.getElementById('LinkList03'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_PageListView', new _WidgetInfo('PageList02', 'sec_Nav_Widgets_2', document.getElementById('PageList02'), {'title': 'Additional Links', 'links': [{'isCurrentPage': false, 'href': '/p/sitemap.html', 'title': 'Sitemap'}, {'isCurrentPage': false, 'href': '#', 'title': 'Disclaimer'}, {'isCurrentPage': false, 'href': '#', 'title': 'Privacy'}], 'mobile': false, 'showPlaceholder': true, 'hasCurrentPage': false}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList04', 'sec_Nav_Widgets_2', document.getElementById('LinkList04'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList05', 'sec_Under_Header', document.getElementById('LinkList05'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList06', 'sec_Under_Header', document.getElementById('LinkList06'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList07', 'sec_Under_Header', document.getElementById('LinkList07'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_HTMLView', new _WidgetInfo('HTML1', 'sec_Horizontal-Ad', document.getElementById('HTML1'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_FeaturedPostView', new _WidgetInfo('FeaturedPost01', 'sec_Top_Widgets', document.getElementById('FeaturedPost01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_BlogView', new _WidgetInfo('Blog01', 'sec_Main_Widgets', document.getElementById('Blog01'), {'cmtInteractionsEnabled': false, 'navMessage': '\u663e\u793a\u6807\u7b7e\u4e3a\u201c\x3cb\x3e\u5d4c\u5165YouTube\u89c6\u9891\x3c/b\x3e\u201d\u7684\u535a\u6587\u3002\x3ca href\x3d\x22https://www.kejiciwei.com/\x22\x3e\u663e\u793a\u6240\u6709\u535a\u6587\x3c/a\x3e', 'lightboxEnabled': true, 'lightboxModuleUrl': 'https://www.blogger.com/static/v1/jsbin/3148571119-lbx__zh_cn.js', 'lightboxCssUrl': 'https://www.blogger.com/static/v1/v-css/828616780-lightbox_bundle.css'}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList08', 'sec_Main_Widgets', document.getElementById('LinkList08'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_HTMLView', new _WidgetInfo('HTML11', 'sec_Main_Widgets', document.getElementById('HTML11'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_ImageView', new _WidgetInfo('Image1', 'sec_Side_Widgets', document.getElementById('Image1'), {'resize': false}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_PopularPostsView', new _WidgetInfo('PopularPosts01', 'sec_Side_Widgets', document.getElementById('PopularPosts01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LabelView', new _WidgetInfo('Label01', 'sec_Side_Widgets', document.getElementById('Label01'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_HTMLView', new _WidgetInfo('HTML404', 'sec_Error_404', document.getElementById('HTML404'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_ImageView', new _WidgetInfo('Image21', 'sec_Footer_Organization', document.getElementById('Image21'), {'resize': true}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList21', 'sec_Footer_Organization', document.getElementById('LinkList21'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList24', 'sec_Footer_Widgets', document.getElementById('LinkList24'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList25', 'sec_Footer_Widgets', document.getElementById('LinkList25'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_TextListView', new _WidgetInfo('TextList99', 'sec_Mobile_Menu', document.getElementById('TextList99'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LabelView', new _WidgetInfo('Label41', 'sec_Theme_Hidden', document.getElementById('Label41'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_ContactFormView', new _WidgetInfo('ContactForm41', 'sec_Theme_Hidden', document.getElementById('ContactForm41'), {'contactFormMessageSendingMsg': '\u6b63\u5728\u53d1\u9001...', 'contactFormMessageSentMsg': '\u60a8\u7684\u90ae\u4ef6\u5df2\u53d1\u9001\u3002', 'contactFormMessageNotSentMsg': '\u90ae\u4ef6\u65e0\u6cd5\u53d1\u9001\uff0c\u8bf7\u7a0d\u540e\u91cd\u8bd5\u3002', 'contactFormInvalidEmailMsg': '\u8bf7\u8f93\u5165\u6709\u6548\u7684\u7535\u5b50\u90ae\u4ef6\u5730\u5740\u3002', 'contactFormEmptyMessageMsg': '\u90ae\u4ef6\u5b57\u6bb5\u4e0d\u80fd\u4e3a\u7a7a\u3002', 'title': '\u8054\u7cfb\u4eba\u8868\u5355', 'blogId': '862577558267434976', 'contactFormNameMsg': '\u540d\u79f0', 'contactFormEmailMsg': '\u7535\u5b50\u90ae\u4ef6', 'contactFormMessageMsg': '\u6d88\u606f', 'contactFormSendMsg': '\u53d1\u9001', 'contactFormToken': 'AEUoTZr-36cKrUCmVDxUvXkT-bke:1783984470393', 'submitUrl': 'https://www.blogger.com/contact-form'}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_StatsView', new _WidgetInfo('Stats41', 'sec_Theme_Hidden', document.getElementById('Stats41'), {'title': 'Pageviews last month', 'showGraphicalCounter': false, 'showAnimatedCounter': false, 'showSparkline': true, 'statsUrl': '//www.kejiciwei.com/b/stats?style\x3dBLACK_TRANSPARENT\x26timeRange\x3dLAST_WEEK\x26token\x3dAFVZEFyRaZS0abFBaPPBDLJ3-G99vQwuhaT1JRFMDXnTxGLf2iLPagr0xCXtUToI_mFWZ6Q2a9zDt_0gwoZgbg'}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_LinkListView', new _WidgetInfo('LinkList63', 'sec_Addon_Widgets', document.getElementById('LinkList63'), {}, 'displayModeFull'));
_WidgetManager._RegisterWidget('_ImageView', new _WidgetInfo('Image61', 'sec_Addon_Widgets', document.getElementById('Image61'), {'resize': false}, 'displayModeFull'));
</script>
</body>