### [MD-Vault：把 Markdown 凭据整理成带 TOTP 的本地看板](https://www.appmiao.com/article/12432)

**Published:** 2026-11-13T08:03:24

**Author:** 阿喵#

**Excerpt:** MD-Vault 是单文件 HTML 凭据看板，可读取 Markdown 文件，提供搜索、复制、拖放和 TOT…

## 阿喵前言

密码明明记在自己写得懂的 Markdown 里，账号一多，查找、复制和两步验证码还是得在编辑器与手机间来回切换？MD-Vault 把这份普通文本整理成可搜索的凭据看板，支持一键复制和 TOTP 倒计时。**数据仍是你能直接打开的 .md 文件，没有私有数据库格式**；但明文也意味着文件和备份要由自己认真保护。

## 资源介绍

MD-Vault 是 MIT 许可的单文件 HTML 凭据看板，读取 Markdown 文件后按标题和键值组织账号卡片，提供搜索、文件切换、拖放及复制功能；约定的 TOTP 区块会显示动态验证码。HTML 与凭据分开保存，模板也可用普通编辑器查看和修改。项目提供在线演示与本地使用方式，适合已经习惯维护文本凭据、希望更快检索的人。

需要分清“本地优先”和“加密保险库”：凭据保存在普通明文 Markdown 中，项目没有已实现的加密层。仓库当前页面还引用 jsDelivr 上的 markdown-it、otpauth 脚本及 fonts.loli.net 字体，因此在线页面会访问这些外部资源；不要仅凭 README 的零网络描述推断该页面在所有运行方式下都完全离线。

### 截图

![MD-Vault Markdown 凭据看板示例界面，含搜索、分组导航与账号卡片](https://oss.amiao.app/website/2026/11/13075937/issue-banner-piclite-advmo-506d88733d3d.webp)

MD-Vault 看板示例界面，账号内容为模板示例。

### 特色

-   直接使用 Markdown 文件，凭据可用常见文本编辑器读取和维护。
-   按文档标题生成侧边导航与账号卡片，并可即时搜索账号、用户名和标签。
-   密码、恢复码及短代码可点按复制，减少手动选取时的误操作。
-   支持通过文件选择或拖放切换 Markdown 文件，也能显示 TOTP 倒计时与动态码。

### 注意

-   Markdown 凭据是明文，不要把真实密码文件提交到公开 Git 仓库；备份与同步也要采用私有存储或额外加密措施。
-   在线演示由 GitHub Pages 托管，实际凭据不应交给公共演示页；在线源码会加载外部脚本和字体，使用前应按自己的信任边界检查。
-   模板含示例账号信息，实际使用前请换成自己的内容；不要将演示数据误当真实凭据或安全模板。

## 使用教程

1.  从 GitHub 仓库下载或克隆项目，将 `index.html` 与自己的 Markdown 凭据文件分开保存。
2.  先复制仓库提供的中文模板结构，用自己的条目替换示例内容；确认没有遗留示例账号，再限制文件及备份的访问权限。
3.  根据 README 使用浏览器打开 `index.html`。如果直接以 `file://` 打开时模板不能自动载入，选择“Open .md File”打开自己的文件，或将文件拖入页面。
4.  在搜索框查找账号；点击凭据区域复制内容。要使用动态验证码，可按模板格式在相应条目加入 `totp` 代码块并填入对应密钥。
5.  工作与个人资料分开保存时，可用页面的文件选择切换不同 Markdown 文件。完成后关闭页面，并继续保护原文件及其同步副本。

## 资源获取

[MD-Vault 在线演示](https://xiangc579.github.io/md-vault) · [GitHub 仓库、源码与中文模板](https://github.com/xiangc579/md-vault)

**Tags:** github开源项目, markdown, 免费开源, 密码管理器, 开发者工具, 开源软件, 本地工具, 隐私保护

**Categories:** 开源项目

---