如何将 Markdown 文档发布为可访问的网站页面？

当你习惯了用 Markdown 记录灵感、组织学术框架，或是频繁接收 AI 生成的结构化 md 文本时，是否想过将这些静态碎片一键转化为属于自己的动态独立网页？

如今，无论是 ChatGPT、Claude 等大语言模型的原生输出，还是 Obsidian、Logseq 等本地双链笔记软件，都无一例外地将 Markdown 作为核心承载格式。它轻量、纯文本、易迁移，天然契合结构化写作的需​​求。

然而，知识如果不流淌，就只是死水。从本地的 .md 文件到互联网上可供他人检索、阅读的漂亮网页，中间往往隔着服务器配置、前端渲染和复杂的发布路径。对于不希望折腾传统静态博客生成器的创作者而言，Halo 作为一款现代开源的独立建站系统，凭借其丰富的生态和极强的扩展性，成为了链接“本地笔记”与“站点文章”的最佳工具之一。

本文将化繁为简，深入探讨如何将 Markdown 文档发布为可访问的网页。我们将立足于 Halo 生态，全面拆解从新手友好的可视化插件，到面向效率极客的编辑器集成（VSCode/Obsidian）及命令行工具（Halo CLI）等六大核心发布路径。无论你的技术背景如何，这篇指南都将帮助你打通内容创作的“最后一公里”，让你的每一篇 Markdown 文档，都能在广袤的万维网中拥有一个优雅的栖息地。

方式一：安装 Markdown 编辑器插件

应用市场提供了多款 Markdown 编辑器插件，安装后可以在控制台直接使用 Markdown 编辑器撰写和发布文章，体验与本地 Markdown 编辑器类似。

前往应用市场浏览所有 Markdown 相关插件：应用市场 - Markdown 插件

方式二：在默认编辑器插入 Markdown 块

如果你大部分时候使用富文本编辑器，只是偶尔需要用 Markdown 语法写某一段内容，可以安装 Markdown / HTML 内容块插件。

安装后，在默认编辑器中可以插入一个独立的 Markdown 块，该块内支持完整的 Markdown 语法，与富文本内容混排。适合以下场景：

• 在富文本文章中插入代码示例或技术说明

• 临时使用 Markdown 语法，无需切换整个编辑器

• 保留部分已有富文本内容，同时用 Markdown 补充新段落

在应用市场搜索 Markdown 内容块 即可安装。

方式三：通过内容助手批量导入 Markdown 文件

内容助手插件支持将本地的 Markdown 文件（包括 .md 文件关联的图片资源）批量导入到 Halo，适合从其他平台迁移内容，或者有大量本地 Markdown 文章需要一次性上传的场景。

使用方式

1. 在应用市场安装内容助手插件；

2. 进入 控制台 → 工具，找到文章导入功能；

3. 上传本地的 Markdown 文件，插件会自动处理文件中引用的图片资源。

方式四：VSCode 插件

vscode-extension-halo 是 Halo 官方维护的 VSCode 扩展，让你可以直接在 VSCode 中将 Markdown 文件发布到 Halo，无需打开浏览器。

主要功能

• 将当前 Markdown 文件一键发布到 Halo

• 自动将文件中引用的本地图片上传到 Halo 附件

• 支持从 Halo 将文章拉取到本地进行编辑

• 支持设置文章的分类和标签

安装方式

在 VSCode 扩展市场搜索 Halo 并安装，然后通过命令面板执行 Halo Setup 配置站点信息即可。

方式五：Obsidian 插件

obsidian-halo 是 Halo 官方维护的 Obsidian 社区插件，适合将 Obsidian 作为主要写作工具的用户，可以直接将笔记发布到 Halo，不打断本地写作流。

主要功能

• 将当前笔记发布到 Halo

• 支持配置多个 Halo 站点，并设置默认站点

• 支持从 Halo 将文章同步回 Obsidian

• 通过命令面板操作，无需离开 Obsidian

安装方式

在 Obsidian 社区插件中搜索 Halo 并安装，然后在插件设置中填写站点地址和 Personal Access Token 即可。

方式六：Halo CLI

Halo CLI 是 Halo 官方提供的命令行工具，支持通过 halo post import-markdown 命令将本地 Markdown 文件导入到 Halo，适合有自动化需求或习惯在终端工作的用户。

安装

npm install -g @halo-dev/cli

登录

halo auth login \
  --profile default \
  --url https://your-halo-site.com \
  --auth-type bearer \
  --token <your-token>

导入 Markdown 文件

halo post import-markdown ./article.md

CLI 还支持文章列表查看、草稿管理、插件和主题操作等功能，可通过 halo --help 查看完整命令列表。

如何选择