{"id":10384,"date":"2026-08-30T17:53:40","date_gmt":"2026-08-30T08:53:40","guid":{"rendered":"https:\/\/www.auctionpro.co.kr\/?p=10384"},"modified":"2026-08-30T17:53:40","modified_gmt":"2026-08-30T08:53:40","slug":"mkdocs","status":"publish","type":"post","link":"https:\/\/www.auctionpro.co.kr\/?p=10384","title":{"rendered":"MkDocs"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\ud55c\uad6d\uc5b4 \ub9c8\ud06c\ub2e4\uc6b4 \uc644\uc804 \uac00\uc774\ub4dc<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udcdd <strong>1. \uc81c\ubaa9<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># \uc81c\ubaa9 1 (\uac00\uc7a5 \ud07c)\n## \uc81c\ubaa9 2\n### \uc81c\ubaa9 3\n#### \uc81c\ubaa9 4\n##### \uc81c\ubaa9 5\n###### \uc81c\ubaa9 6 (\uac00\uc7a5 \uc791\uc74c)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\uc81c\ubaa9 1 (\uac00\uc7a5 \ud07c)\n\uc81c\ubaa9 2\n\uc81c\ubaa9 3<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udd24 <strong>2. \ud14d\uc2a4\ud2b8 \ud3ec\ub9f7<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>**\uad75\uc740 \ud14d\uc2a4\ud2b8** (\uc911\uc694\ud568)\n*\uae30\uc6b8\uc778 \ud14d\uc2a4\ud2b8* (\uac15\uc870)\n***\uad75\uace0 \uae30\uc6b8\uc778 \ud14d\uc2a4\ud2b8***\n~~\ucde8\uc18c\uc120~~ (\uc9c0\uc6cc\uc9c4 \ud14d\uc2a4\ud2b8)\n`\uc778\ub77c\uc778 \ucf54\ub4dc`<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\uad75\uc740 \ud14d\uc2a4\ud2b8<\/strong><\/li>\n\n\n\n<li><em>\uae30\uc6b8\uc778 \ud14d\uc2a4\ud2b8<\/em><\/li>\n\n\n\n<li><em><strong>\uad75\uace0 \uae30\uc6b8\uc778 \ud14d\uc2a4\ud2b8<\/strong><\/em><\/li>\n\n\n\n<li><del>\ucde8\uc18c\uc120<\/del><\/li>\n\n\n\n<li><code>\uc778\ub77c\uc778 \ucf54\ub4dc<\/code><\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udccb <strong>3. \uc21c\uc11c \uc788\ub294 \ub9ac\uc2a4\ud2b8<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>1. \uccab \ubc88\uc9f8 \ud56d\ubaa9\n2. \ub450 \ubc88\uc9f8 \ud56d\ubaa9\n3. \uc138 \ubc88\uc9f8 \ud56d\ubaa9\n   1. \ud558\uc704 \ud56d\ubaa9 1\n   2. \ud558\uc704 \ud56d\ubaa9 2\n4. \ub124 \ubc88\uc9f8 \ud56d\ubaa9<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>\uccab \ubc88\uc9f8 \ud56d\ubaa9<\/li>\n\n\n\n<li>\ub450 \ubc88\uc9f8 \ud56d\ubaa9<\/li>\n\n\n\n<li>\uc138 \ubc88\uc9f8 \ud56d\ubaa9\n<ol class=\"wp-block-list\">\n<li>\ud558\uc704 \ud56d\ubaa9 1<\/li>\n\n\n\n<li>\ud558\uc704 \ud56d\ubaa9 2<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udd39 <strong>4. \uc21c\uc11c \uc5c6\ub294 \ub9ac\uc2a4\ud2b8<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>- \ud56d\ubaa9 1\n- \ud56d\ubaa9 2\n  - \ud558\uc704 \ud56d\ubaa9 2-1\n  - \ud558\uc704 \ud56d\ubaa9 2-2\n    - \ub354 \uae4a\uc740 \ud56d\ubaa9\n- \ud56d\ubaa9 3\n\n* \ubcc4\ud45c\ub85c\ub3c4 \uac00\ub2a5\n* \ud56d\ubaa9 2<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud56d\ubaa9 1<\/li>\n\n\n\n<li>\ud56d\ubaa9 2\n<ul class=\"wp-block-list\">\n<li>\ud558\uc704 \ud56d\ubaa9 2-1<\/li>\n\n\n\n<li>\ud558\uc704 \ud56d\ubaa9 2-2<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>\ud56d\ubaa9 3<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u2705 <strong>5. \uccb4\ud06c\ub9ac\uc2a4\ud2b8<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>- &#91;x] \uc644\ub8cc\ub41c \uc791\uc5c5\n- &#91;x] \ub2e4\ub978 \uc644\ub8cc \uc791\uc5c5\n- &#91; ] \uc544\uc9c1 \uc548 \ud55c \uc791\uc5c5\n- &#91; ] \ud574\uc57c \ud560 \uc791\uc5c5<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc644\ub8cc\ub41c \uc791\uc5c5<\/li>\n\n\n\n<li>\ub2e4\ub978 \uc644\ub8cc \uc791\uc5c5<\/li>\n\n\n\n<li>\uc544\uc9c1 \uc548 \ud55c \uc791\uc5c5<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udd17 <strong>6. \ub9c1\ud06c<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;\ub9c1\ud06c \ud14d\uc2a4\ud2b8](https:\/\/example.com)\n\n&#91;\uc0c8 \ud0ed\uc5d0\uc11c \uc5f4\uae30](https:\/\/example.com){target=\"_blank\"}\n\n&#91;\uac19\uc740 \uc0ac\uc774\ud2b8 \ub9c1\ud06c](..\/guide\/start.md)\n\n&#91;\uc575\ucee4 \ub9c1\ud06c](#42-\uc21c\uc11c-\uc5c6\ub294-\ub9ac\uc2a4\ud2b8)\n\n&lt;https:\/\/example.com&gt;<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\uddbc\ufe0f <strong>7. \uc774\ubbf8\uc9c0<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>!&#91;\uc774\ubbf8\uc9c0 \uc124\uba85](..\/images\/logo.png)\n\n!&#91;\ud06c\uae30 \uc870\uc808](..\/images\/screenshot.png){width=\"500\"}\n\n&#91;!&#91;\ud074\ub9ad\ud558\uba74 \ub9c1\ud06c](..\/images\/thumbnail.png)](https:\/\/example.com)<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udcca <strong>8. \ud45c (\ud14c\uc774\ube14)<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>| \ud56d\ubaa9 | \uc124\uba85 | \uac00\uaca9 |\n|------|------|------|\n| \uc0c1\ud488 1 | \uc124\uba85\uc785\ub2c8\ub2e4 | 10,000\uc6d0 |\n| \uc0c1\ud488 2 | \ub2e4\ub978 \uc124\uba85 | 20,000\uc6d0 |\n| \uc0c1\ud488 3 | \ub610 \ub2e4\ub978 \uc124\uba85 | 30,000\uc6d0 |\n\n| \uc67c\ucabd \uc815\ub82c | \uc911\uc559 \uc815\ub82c | \uc624\ub978\ucabd \uc815\ub82c |\n|:------|:------:|------:|\n| \uc67c\ucabd | \uc911\uc559 | \uc624\ub978\ucabd |\n| \ud14d\uc2a4\ud2b8 | \uc815\ub82c\ub428 | \ub428 |<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>\ud56d\ubaa9<\/th><th>\uc124\uba85<\/th><th>\uac00\uaca9<\/th><\/tr><\/thead><tbody><tr><td>\uc0c1\ud488 1<\/td><td>\uc124\uba85\uc785\ub2c8\ub2e4<\/td><td>10,000\uc6d0<\/td><\/tr><tr><td>\uc0c1\ud488 2<\/td><td>\ub2e4\ub978 \uc124\uba85<\/td><td>20,000\uc6d0<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udcac <strong>9. \uc778\uc6a9\uad6c (Blockquote)<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&gt; \uc774\uac83\uc740 \uc778\uc6a9\uad6c\uc785\ub2c8\ub2e4.\n&gt; \uc5ec\ub7ec \uc904\ub3c4 \uac00\ub2a5\ud569\ub2c8\ub2e4.\n\n&gt; **\uc911\uc694\ud55c \uc778\uc6a9\uad6c**\n&gt; \uad75\uc740 \ud14d\uc2a4\ud2b8\ub3c4 \uac00\ub2a5\ud569\ub2c8\ub2e4.\n\n&gt; \uccab \ubc88\uc9f8 \uc778\uc6a9\n&gt; &gt; \uc911\ucca9\ub41c \uc778\uc6a9\n&gt; &gt; &gt; \ub354 \uae4a\uc740 \uc911\ucca9<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong><\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\uc774\uac83\uc740 \uc778\uc6a9\uad6c\uc785\ub2c8\ub2e4.<br>\uc5ec\ub7ec \uc904\ub3c4 \uac00\ub2a5\ud569\ub2c8\ub2e4.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udcbb <strong>10. \ucf54\ub4dc \ube14\ub85d<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>```python\ndef hello():\n    print(\"\uc548\ub155\ud558\uc138\uc694!\")\n    return True\n```\n\n```bash\n#!\/bin\/bash\necho \"\uc258 \uc2a4\ud06c\ub9bd\ud2b8\"\nmkdocs serve\n```\n\n```json\n{\n  \"\uc774\ub984\": \"\ud504\ub85c\uc81d\ud2b8\",\n  \"\ubc84\uc804\": \"1.0.0\"\n}\n```<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udccc <strong>11. \uc218\ud3c9\uc120<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>---\n\n\ub610\ub294\n\n***\n\n\ub610\ub294\n\n___<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uacb0\uacfc:<\/strong> \uac00\ub85c\uc904\uc774 \uadf8\uc5b4\uc9d0<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83d\udccc <strong>12. \ud0c8\ucd9c \ubb38\uc790<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\\*\ubcc4\ud45c\ub97c \ud45c\uc2dc\ud558\ub824\uba74\\*\n\\&#91;\ub300\uad04\ud638\\]\n\\# \ud574\uc2dc\ud0dc\uadf8<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83c\udfaf <strong>\uc644\uc804\ud55c \ud55c\uad6d\uc5b4 \uc608\uc2dc \ubb38\uc11c<\/strong><\/h3>\n\n\n\n<h4 class=\"wp-block-heading\"><strong><code>docs\/guide\/complete-example.md<\/code>:<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># \uc644\uc804\ud55c \ub9c8\ud06c\ub2e4\uc6b4 \uc608\uc2dc\n\n## 1. \uc18c\uac1c\n\n\uc774\uac83\uc740 **\uc644\uc804\ud55c \ub9c8\ud06c\ub2e4\uc6b4** \uc608\uc2dc \ubb38\uc11c\uc785\ub2c8\ub2e4.\n*\ubaa8\ub4e0 \uae30\ub2a5*\uc744 \ud3ec\ud568\ud558\uace0 \uc788\uc2b5\ub2c8\ub2e4.\n\n!&#91;\uae30\uc220 \ubb38\uc11c \ub85c\uace0](..\/images\/logo.png){width=\"300\"}\n\n---\n\n## 2. \uc124\uce58 \uac00\uc774\ub4dc\n\n### \uc694\uad6c\uc0ac\ud56d\n\n- Python 3.8 \uc774\uc0c1\n- pip (\ud30c\uc774\uc36c \ud328\ud0a4\uc9c0 \uad00\ub9ac\uc790)\n- Windows, macOS, \ub610\ub294 Linux\n\n### \uc124\uce58 \ub2e8\uacc4\n\n1. **Python \ub2e4\uc6b4\ub85c\ub4dc**\n   - &#91;Python \uacf5\uc2dd \uc6f9\uc0ac\uc774\ud2b8](https:\/\/python.org) \ubc29\ubb38\n   - \ucd5c\uc2e0 \ubc84\uc804 \ub2e4\uc6b4\ub85c\ub4dc\n\n2. **\uc124\uce58 \uc2e4\ud589**\n   - \ub2e4\uc6b4\ub85c\ub4dc\ud55c \uc124\uce58 \ud30c\uc77c \uc2e4\ud589\n   - \"Add Python to PATH\" \uccb4\ud06c (\uc911\uc694!)\n\n3. **\uc124\uce58 \ud655\uc778**\n\n```bash\npython --version\npip --version\n```\n\n4. **\ud504\ub85c\uc81d\ud2b8 \uc0dd\uc131**\n\n```cmd\nmkdocs new my-project\ncd my-project\n```\n\n---\n\n## 3. \uae30\ub2a5 \ube44\uad50\ud45c\n\n| \uae30\ub2a5 | MkDocs | Sphinx | Docusaurus |\n|------|:------:|:------:|:----------:|\n| \ud559\uc2b5 \ub09c\uc774\ub3c4 | \uc26c\uc6c0 | \uc5b4\ub824\uc6c0 | \uc911\uac04 |\n| \ub9c8\ud06c\ub2e4\uc6b4 \uc9c0\uc6d0 | \u2705 \uc644\ubcbd | \u26a0\ufe0f \uc81c\ud55c | \u2705 \uc644\ubcbd |\n| \ud14c\ub9c8 \ud48d\ubd80 | \u2705 \ub9ce\uc74c | \u2705 \ub9ce\uc74c | \u26a0\ufe0f \uc801\uc74c |\n| \ucee4\ubba4\ub2c8\ud2f0 | \u2705 \ud07c | \u2705 \ud07c | \u26a0\ufe0f \uc791\uc74c |\n\n---\n\n## 4. \uc8fc\uc694 \ud2b9\uc9d5\n\n&gt; **\ud575\uc2ec \uae30\ub2a5**\n&gt; \n&gt; MkDocs\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \ud2b9\uc9d5\uc744 \uac00\uc9c0\uace0 \uc788\uc2b5\ub2c8\ub2e4:\n\n- \ub9c8\ud06c\ub2e4\uc6b4 \uae30\ubc18 \ubb38\uc11c\ud654\n- \uc790\ub3d9 \ub124\ube44\uac8c\uc774\uc158 \uc0dd\uc131\n- \ub77c\uc774\ube0c \uc11c\ubc84 \ubbf8\ub9ac\ubcf4\uae30\n- \uc815\uc801 \uc0ac\uc774\ud2b8 \uc0dd\uc131\n- \ubb34\ub8cc \ud638\uc2a4\ud305 \uac00\ub2a5\n\n---\n\n## 5. \uc790\uc8fc \ubb3b\ub294 \uc9c8\ubb38 (FAQ)\n\n### Q1. MkDocs\ub294 \ubb34\ub8cc\uc778\uac00\uc694?\n\n**\ub2f5:** \ub124, \uc644\uc804\ud788 \ubb34\ub8cc\uc774\uba70 \uc624\ud508\uc18c\uc2a4\uc785\ub2c8\ub2e4.\n\n### Q2. \ub2e4\uad6d\uc5b4\ub97c \uc9c0\uc6d0\ud558\ub098\uc694?\n\n**\ub2f5:** Material for MkDocs\ub294 \ub2e4\uad6d\uc5b4\ub97c \uc9c0\uc6d0\ud569\ub2c8\ub2e4.\n\uc9c0\uc6d0\ud558\ub294 \uc5b8\uc5b4:\n- \ud55c\uad6d\uc5b4 (ko)\n- \uc601\uc5b4 (en)\n- \uc77c\ubcf8\uc5b4 (ja)\n- \uc911\uad6d\uc5b4 (zh)\n- \ub4f1\ub4f1\n\n### Q3. \ubc30\ud3ec\ub294 \uc5b4\ub835\ub098\uc694?\n\n**\ub2f5:** \ub9e4\uc6b0 \uac04\ub2e8\ud569\ub2c8\ub2e4!\n\n```bash\n# GitHub Pages\uc5d0 \ubc30\ud3ec\nmkdocs gh-deploy\n\n# Netlify\uc5d0 \ubc30\ud3ec (site\/ \ud3f4\ub354 \uc5c5\ub85c\ub4dc)\nmkdocs build\n```\n\n---\n\n## 6. \ucf54\ub4dc \uc608\uc81c\n\n### Python \uc608\uc81c\n\n```python\n# MkDocs\ub294 \ub9c8\ud06c\ub2e4\uc6b4\uc73c\ub85c \uc791\uc131\ud569\ub2c8\ub2e4\nimport mkdocs\n\ndef create_docs():\n    \"\"\"\n    \ubb38\uc11c\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4\n    \"\"\"\n    print(\"\ubb38\uc11c \uc0dd\uc131 \uc911...\")\n    return True\n\nresult = create_docs()\n```\n\n### Bash \uc608\uc81c\n\n```bash\n#!\/bin\/bash\n# MkDocs \ubc30\ud3ec \uc2a4\ud06c\ub9bd\ud2b8\n\necho \"=== MkDocs \ube4c\ub4dc ===\"\nmkdocs build\n\necho \"=== \ubc30\ud3ec \uc644\ub8cc ===\"\necho \"site\/ \ud3f4\ub354\uac00 \uc900\ube44\ub418\uc5c8\uc2b5\ub2c8\ub2e4\"\n```\n\n### \uc124\uc815 \uc608\uc81c\n\n```yaml\n# mkdocs.yml\nsite_name: \uae30\uc220 \ubb38\uc11c\nsite_description: \uc644\uc804\ud55c \uae30\uc220 \uac00\uc774\ub4dc\n\ntheme:\n  name: material\n  language: ko\n\nnav:\n  - \ud648: index.md\n  - \uc124\uce58: install.md\n  - \uac00\uc774\ub4dc: guide.md\n```\n\n---\n\n## 7. \uccb4\ud06c\ub9ac\uc2a4\ud2b8\n\n- &#91;x] \ub9c8\ud06c\ub2e4\uc6b4 \ud559\uc2b5\n- &#91;x] MkDocs \uc124\uce58\n- &#91;x] \ud504\ub85c\uc81d\ud2b8 \uc0dd\uc131\n- &#91;x] \ubb38\uc11c \uc791\uc131 \uc2dc\uc791\n- &#91; ] \uc6f9\uc5d0 \ubc30\ud3ec\n- &#91; ] \ud300\uacfc \uacf5\uc720\n\n---\n\n## 8. \ub2e4\uc74c \ub2e8\uacc4\n\n1. **\ubb38\uc11c \uc791\uc131** - \ud504\ub85c\uc81d\ud2b8\uc5d0 \ub9de\uac8c \ub9c8\ud06c\ub2e4\uc6b4 \ud30c\uc77c \uc791\uc131\n2. **\ud14c\ub9c8 \ucee4\uc2a4\ud130\ub9c8\uc774\uc9d5** - Material for MkDocs \ud14c\ub9c8 \uc124\uc815\n3. **\ubc30\ud3ec** - GitHub Pages \ub610\ub294 Netlify\uc5d0 \ubc30\ud3ec\n4. **\uc720\uc9c0\ubcf4\uc218** - \ubb38\uc11c \uc815\uae30\uc801\uc73c\ub85c \uc5c5\ub370\uc774\ud2b8\n\n---\n\n## 9. \uc720\uc6a9\ud55c \ub9c1\ud06c\n\n- &#91;MkDocs \uacf5\uc2dd \ubb38\uc11c](https:\/\/www.mkdocs.org\/)\n- &#91;Material for MkDocs](https:\/\/squidfunk.github.io\/mkdocs-material\/)\n- &#91;\ub9c8\ud06c\ub2e4\uc6b4 \uac00\uc774\ub4dc](https:\/\/www.markdownguide.org\/)\n\n---\n\n&gt; **\ud301**\n&gt; \n&gt; Material for MkDocs\ub97c \uc0ac\uc6a9\ud558\uba74 \uc804\ubb38\uc801\uc778 \ubb38\uc11c\ub97c \uc27d\uac8c \ub9cc\ub4e4 \uc218 \uc788\uc2b5\ub2c8\ub2e4!\n\n\ub9c8\uc9c0\ub9c9\uc73c\ub85c **Happy Documenting! \ud83c\udf89**<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\ud83c\udfa8 <strong>\ucd94\uac00 \ud55c\uad6d\uc5b4 \uc608\uc2dc\ub4e4<\/strong><\/h3>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>\uae30\uc220 \ubb38\uc11c \uc608\uc2dc<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># API \ubb38\uc11c\n\n## \uc5d4\ub4dc\ud3ec\uc778\ud2b8\n\n### POST \/api\/users\n\n\uc0ac\uc6a9\uc790\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4.\n\n**\uc694\uccad:**\n\n```json\n{\n  \"\uc774\ub984\": \"\uae40\ucca0\uc218\",\n  \"\uc774\uba54\uc77c\": \"kim@example.com\",\n  \"\ub098\uc774\": 30\n}\n```\n\n**\uc751\ub2f5:**\n\n```json\n{\n  \"\uc131\uacf5\": true,\n  \"\uc0ac\uc6a9\uc790ID\": 12345,\n  \"\uba54\uc2dc\uc9c0\": \"\uc0ac\uc6a9\uc790\uac00 \uc0dd\uc131\ub418\uc5c8\uc2b5\ub2c8\ub2e4\"\n}\n```\n\n**\uc624\ub958:**\n\n| \ucf54\ub4dc | \uc124\uba85 |\n|------|------|\n| 400 | \uc798\ubabb\ub41c \uc694\uccad |\n| 401 | \uc778\uc99d \uc2e4\ud328 |\n| 500 | \uc11c\ubc84 \uc624\ub958 |<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\"><strong>\ud29c\ud1a0\ub9ac\uc5bc \uc608\uc2dc<\/strong><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">markdown<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># Python \uc2dc\uc791\ud558\uae30\n\n## 1\ub2e8\uacc4: \ud658\uacbd \uc124\uc815\n\n\uba3c\uc800 Python\uc744 \uc124\uce58\ud574\uc57c \ud569\ub2c8\ub2e4.\n\n```bash\npython --version\n```\n\n## 2\ub2e8\uacc4: \uccab \ud504\ub85c\uadf8\ub7a8\n\n```python\n# hello.py\nprint(\"\uc548\ub155\ud558\uc138\uc694!\")\n```\n\n\uc2e4\ud589\ud558\ub824\uba74:\n\n```bash\npython hello.py\n```\n\n## 3\ub2e8\uacc4: \ud568\uc218 \ub9cc\ub4e4\uae30\n\n```python\ndef \uc778\uc0ac(\uc774\ub984):\n    return f\"\uc548\ub155\ud558\uc138\uc694, {\uc774\ub984}\ub2d8!\"\n\n\uacb0\uacfc = \uc778\uc0ac(\"\ucca0\uc218\")\nprint(\uacb0\uacfc)\n```<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h3 class=\"wp-block-heading\">\u2705 <strong>\uccb4\ud06c\ub9ac\uc2a4\ud2b8: \ub9c8\ud06c\ub2e4\uc6b4 \ubaa8\ub4e0 \uae30\ub2a5<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc81c\ubaa9 (H1 ~ H6)<\/li>\n\n\n\n<li>\ud14d\uc2a4\ud2b8 \ud3ec\ub9f7 (\uad75\uae30, \uae30\uc6b8\uc784)<\/li>\n\n\n\n<li>\ub9ac\uc2a4\ud2b8 (\uc21c\uc11c \uc788\uc74c\/\uc5c6\uc74c)<\/li>\n\n\n\n<li>\ub9c1\ud06c<\/li>\n\n\n\n<li>\uc774\ubbf8\uc9c0<\/li>\n\n\n\n<li>\ucf54\ub4dc \ube14\ub85d<\/li>\n\n\n\n<li>\ud45c<\/li>\n\n\n\n<li>\uc778\uc6a9\uad6c<\/li>\n\n\n\n<li>\uc218\ud3c9\uc120<\/li>\n\n\n\n<li>\uccb4\ud06c\ub9ac\uc2a4\ud2b8<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<div class=\"mh-excerpt\"><p>\ud55c\uad6d\uc5b4 \ub9c8\ud06c\ub2e4\uc6b4 \uc644\uc804 \uac00\uc774\ub4dc \ud83d\udcdd 1. \uc81c\ubaa9 markdown \uacb0\uacfc: \ud83d\udd24 2. \ud14d\uc2a4\ud2b8 \ud3ec\ub9f7 markdown \uacb0\uacfc: \ud83d\udccb 3. \uc21c\uc11c \uc788\ub294 \ub9ac\uc2a4\ud2b8 markdown \uacb0\uacfc: \ud83d\udd39 4. \uc21c\uc11c <a class=\"mh-excerpt-more\" href=\"https:\/\/www.auctionpro.co.kr\/?p=10384\" title=\"MkDocs\">[&#8230;]<\/a><\/p>\n<\/div>","protected":false},"author":6,"featured_media":10281,"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-10384","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\/06\/pexels-photo-34803995.jpeg","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10384","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=10384"}],"version-history":[{"count":1,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10384\/revisions"}],"predecessor-version":[{"id":10385,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/10384\/revisions\/10385"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/media\/10281"}],"wp:attachment":[{"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10384"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10384"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10384"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}