{"id":10382,"date":"2026-08-30T17:09:42","date_gmt":"2026-08-30T08:09:42","guid":{"rendered":"https:\/\/www.auctionpro.co.kr\/?p=10382"},"modified":"2026-08-30T17:09:42","modified_gmt":"2026-08-30T08:09:42","slug":"mkdocs%eb%9e%80","status":"publish","type":"post","link":"https:\/\/www.auctionpro.co.kr\/?p=10382","title":{"rendered":"MkDocs\ub780?"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><strong>\ud2b9\uc9d5:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ub9c8\ud06c\ub2e4\uc6b4 \uc804\uc6a9 (\ubc30\uc6b0\uae30 \uc26c\uc6c0)<\/li>\n\n\n\n<li>\ube60\ub978 \uac80\uc0c9, \uae54\ub054\ud55c UI<\/li>\n\n\n\n<li>\ud50c\ub7ec\uadf8\uc778 \ud48d\ubd80<\/li>\n\n\n\n<li>\uc815\uc801 \uc0ac\uc774\ud2b8 \uc0dd\uc131<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uc7a5\uc810:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc124\uc815 \uac04\ub2e8 (YAML)<\/li>\n\n\n\n<li>\ub85c\uceec \uac1c\ubc1c \uc11c\ubc84 \ube60\ub984<\/li>\n\n\n\n<li>Vercel\/Netlify\/GitHub Pages \ubc30\ud3ec \uc6a9\uc774<\/li>\n\n\n\n<li>Material for MkDocs \ud14c\ub9c8 \uc6b0\uc218<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>\uc815\uc758<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>MkDocs<\/strong>\ub294 \ub9c8\ud06c\ub2e4\uc6b4 \ud30c\uc77c\ub85c \uc791\uc131\ud55c \uae30\uc220 \ubb38\uc11c\ub97c <strong>\uc815\uc801 \uc6f9\uc0ac\uc774\ud2b8<\/strong>\ub85c \uc790\ub3d9 \ubcc0\ud658\ud574\uc8fc\ub294 \uc624\ud508\uc18c\uc2a4 \ub3c4\uad6c\uc785\ub2c8\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\ub9c8\ud06c\ub2e4\uc6b4 \ud30c\uc77c\ub4e4 (.md)\n      \u2193\n   MkDocs\n      \u2193\n\uc644\uc131\ub41c \uc6f9\uc0ac\uc774\ud2b8 (HTML + CSS + JS)<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83c\udfaf <strong>\ud575\uc2ec \ud2b9\uc9d5<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>\ud56d\ubaa9<\/th><th>\uc124\uba85<\/th><\/tr><\/thead><tbody><tr><td><strong>\uc5b8\uc5b4<\/strong><\/td><td>Python \uae30\ubc18<\/td><\/tr><tr><td><strong>\uc785\ub825<\/strong><\/td><td>\ub9c8\ud06c\ub2e4\uc6b4 (.md)<\/td><\/tr><tr><td><strong>\ucd9c\ub825<\/strong><\/td><td>\uc815\uc801 HTML \uc6f9\uc0ac\uc774\ud2b8<\/td><\/tr><tr><td><strong>\ub77c\uc774\uc120\uc2a4<\/strong><\/td><td>BSD \uc624\ud508\uc18c\uc2a4 (\ubb34\ub8cc)<\/td><\/tr><tr><td><strong>\uc124\uce58<\/strong><\/td><td><code>pip install mkdocs<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\ude80 <strong>\uc8fc\uc694 \uae30\ub2a5<\/strong><\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">1\ufe0f\u20e3 <strong>\ub9c8\ud06c\ub2e4\uc6b4 \uae30\ubc18<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># \uc81c\ubaa9 1\n## \uc81c\ubaa9 2\n### \uc81c\ubaa9 3\n\n- \ub9ac\uc2a4\ud2b8 \ud56d\ubaa9\n- \ub610 \ub2e4\ub978 \ud56d\ubaa9\n\n**\uad75\uc740 \ud14d\uc2a4\ud2b8**, *\uae30\uc6b8\uc784*\n\n&#91;\ub9c1\ud06c](https:\/\/example.com)<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">2\ufe0f\u20e3 <strong>\uc790\ub3d9 \ub124\ube44\uac8c\uc774\uc158<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ub514\ub809\ud1a0\ub9ac \uad6c\uc870 \u2192 \uc790\ub3d9 \uba54\ub274 \uc0dd\uc131<\/li>\n\n\n\n<li>\ubaa9\ucc28 \uc790\ub3d9 \uc0dd\uc131<\/li>\n\n\n\n<li>\uac80\uc0c9 \uae30\ub2a5 \ub0b4\uc7a5<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">3\ufe0f\u20e3 <strong>\ub77c\uc774\ube0c \ud504\ub9ac\ubdf0<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">bash<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>mkdocs serve\n# http:\/\/localhost:8000 \uc5d0\uc11c \uc2e4\uc2dc\uac04 \ud655\uc778<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">4\ufe0f\u20e3 <strong>\ud14c\ub9c8 \uc9c0\uc6d0<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uae30\ubcf8 \ud14c\ub9c8 \ud3ec\ud568<\/li>\n\n\n\n<li><strong>Material for MkDocs<\/strong> (\uac00\uc7a5 \uc778\uae30)<\/li>\n\n\n\n<li>\ucd94\uac00 \ud14c\ub9c8 \ub2e4\uc218<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">5\ufe0f\u20e3 <strong>\ud50c\ub7ec\uadf8\uc778<\/strong><\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uac80\uc0c9 \uace0\ub3c4\ud654<\/li>\n\n\n\n<li>\ub2e4\uad6d\uc5b4 \uc9c0\uc6d0<\/li>\n\n\n\n<li>SEO \ucd5c\uc801\ud654<\/li>\n\n\n\n<li>\ub4f1\ub4f1<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udcc1 <strong>\ud504\ub85c\uc81d\ud2b8 \uad6c\uc870<\/strong><\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>my-project\/\n\u251c\u2500\u2500 mkdocs.yml              # \uc124\uc815 \ud30c\uc77c\n\u251c\u2500\u2500 docs\/\n\u2502   \u251c\u2500\u2500 index.md           # \ud648\ud398\uc774\uc9c0\n\u2502   \u251c\u2500\u2500 getting-started.md\n\u2502   \u251c\u2500\u2500 installation.md\n\u2502   \u251c\u2500\u2500 api\/\n\u2502   \u2502   \u251c\u2500\u2500 overview.md\n\u2502   \u2502   \u2514\u2500\u2500 reference.md\n\u2502   \u2514\u2500\u2500 guide\/\n\u2502       \u2514\u2500\u2500 tutorial.md\n\u2514\u2500\u2500 site\/                   # \uc0dd\uc131\ub41c \uc6f9\uc0ac\uc774\ud2b8 (\ubc30\ud3ec\uc6a9)<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">\u2699\ufe0f <strong>\uc124\uc815 \ud30c\uc77c \uc608\uc2dc<\/strong> (mkdocs.yml)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">yaml<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>site_name: My Project\nsite_description: \ud504\ub85c\uc81d\ud2b8 \ubb38\uc11c\n\ntheme:\n  name: material\n  language: ko\n\nnav:\n  - Home: index.md\n  - \uc2dc\uc791\ud558\uae30: getting-started.md\n  - \uc124\uce58: installation.md\n  - API:\n    - \uac1c\uc694: api\/overview.md\n    - \ub808\ud37c\ub7f0\uc2a4: api\/reference.md\n  - \uac00\uc774\ub4dc: guide\/tutorial.md\n\nplugins:\n  - search<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udd04 <strong>\uc791\uc5c5 \ud750\ub984<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">bash<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># 1\ufe0f\u20e3 \uc124\uce58\npip install mkdocs mkdocs-material\n\n# 2\ufe0f\u20e3 \ud504\ub85c\uc81d\ud2b8 \uc0dd\uc131\nmkdocs new my-docs\n\n# 3\ufe0f\u20e3 \ub9c8\ud06c\ub2e4\uc6b4 \uc791\uc131\n# docs\/ \ud3f4\ub354\uc5d0 .md \ud30c\uc77c \uc0dd\uc131\n\n# 4\ufe0f\u20e3 \ub85c\uceec\uc5d0\uc11c \ubbf8\ub9ac\ubcf4\uae30\nmkdocs serve\n\n# 5\ufe0f\u20e3 \ubc30\ud3ec\uc6a9 \ube4c\ub4dc\nmkdocs build\n\n# 6\ufe0f\u20e3 \uc6f9\uc5d0 \ubc30\ud3ec\n# site\/ \ud3f4\ub354\ub97c \ud638\uc2a4\ud305 \uc11c\ubc84\uc5d0 \uc5c5\ub85c\ub4dc<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<div class=\"mh-excerpt\"><p>\ud2b9\uc9d5: \uc7a5\uc810: \uc815\uc758 MkDocs\ub294 \ub9c8\ud06c\ub2e4\uc6b4 \ud30c\uc77c\ub85c \uc791\uc131\ud55c \uae30\uc220 \ubb38\uc11c\ub97c \uc815\uc801 \uc6f9\uc0ac\uc774\ud2b8\ub85c \uc790\ub3d9 \ubcc0\ud658\ud574\uc8fc\ub294 \uc624\ud508\uc18c\uc2a4 \ub3c4\uad6c\uc785\ub2c8\ub2e4. \ud83c\udfaf \ud575\uc2ec \ud2b9\uc9d5 \ud56d\ubaa9 \uc124\uba85 \uc5b8\uc5b4 Python \uae30\ubc18 \uc785\ub825 \ub9c8\ud06c\ub2e4\uc6b4 <a class=\"mh-excerpt-more\" href=\"https:\/\/www.auctionpro.co.kr\/?p=10382\" title=\"MkDocs\ub780?\">[&#8230;]<\/a><\/p>\n<\/div>","protected":false},"author":6,"featured_media":10294,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[39],"tags":[],"class_list":["post-10382","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-free-util"],"jetpack_featured_media_url":"https:\/\/www.auctionpro.co.kr\/wp-content\/uploads\/2026\/04\/pexels-photo-574071.jpeg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10382","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10382"}],"version-history":[{"count":1,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10382\/revisions"}],"predecessor-version":[{"id":10383,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10382\/revisions\/10383"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/media\/10294"}],"wp:attachment":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10382"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10382"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10382"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}