Markdown 阅读器:在线阅读 .md 文件

给文档一个舒适的阅读空间。打开 Markdown 文件,沿着标题浏览,并为真正需要阅读的正文安排时间。

打开 .md 或 .markdown 文件、粘贴草稿,或试读本站的编辑出版示例。

本地阅读 · 文档不上传 · 刷新后不保留内容

什么是 Markdown 阅读器?

Markdown 是一种用少量标记描述结构的纯文本格式:井号表示标题,方括号可以把短语变成链接。.md 文件本身能在普通文本应用中阅读,但长列表、表格和多层章节经过排版后更容易理解。在线 Markdown 阅读器提供独立的阅读空间,无需配置项目或开发环境。

WordToTime 优先展示文档正文,帮助你理解文章、查看标题结构,并了解前面还有多少内容。源码视图可用于检查和复制。阅读器不会修改原文件,不管理代码仓库,也不提供转换为其他格式的文件下载。

如何在浏览器中打开 Markdown 文件

选择本地 .md 或 .markdown 文件,在输入面板粘贴 Markdown,或试读本站原创的 Editorial Publishing Notes 示例。示例包含出版检查清单和交接表格,可以先熟悉阅读方式,再打开自己的文档。文件在设备上按 UTF-8 解码,也兼容 UTF-8 BOM。

文档默认以排版后的视图打开。需要核对缩进或代码围栏时,可切换到源码。切换界面语言只保留内存中的同一份文档,绝不会翻译正文。刷新或关闭页面会清除文档和阅读位置。请保留自己的原文件,本页不提供云端备份或自动保存。

更舒适地阅读 Markdown

通过文档目录跳转到各级标题,同名标题也有独立目标。在手机上,目录可以折叠在正文上方。字号、行距和列宽可以分别调整:较窄的文字列适合跟读教程,较宽的文字列则方便对照简短的列表条目。

阅读区域支持浅色、深色和跟随系统主题。表格和代码块在自身区域内横向滚动,不会撑宽整页。专注阅读会展开阅读器;浏览器不支持原生全屏时,则使用窗口内的专注视图。搜索只针对当前文档,进度条跟随实际阅读区域的滚动位置。

支持哪些 Markdown 格式?

支持 CommonMark 的标题、段落、强调、引用、嵌套列表、链接、分隔线、行内代码和围栏代码。GitHub Flavored Markdown 扩展增加了表格、只读任务清单、删除线、自动链接和脚注。这些功能超出纯 CommonMark 的范围,使用其他方言的阅读器可能会显示不同的结果。

嵌入的原始 HTML 会被忽略。图片显示为带说明的占位,包括无法从单个文件解析的相对路径。MDX、JSX、Mermaid、PlantUML 和数学宏均不执行,也不会转换成图表。围栏中的示例始终作为代码文本展示,避免阅读陌生文档时自动运行扩展或联系图表服务。

估算 Markdown 文档的阅读时间

阅读时间使用解析后提取的文本,包含可见标题、正文、列表、表格、引用、行内代码和已引用的脚注。语法标记、链接目标、frontmatter 元数据和图片说明不计入。围栏代码默认排除,只有启用选项后才计入。因此,把一句话改成标题或加粗,并不会把标记符号算成额外阅读量。

词语分段使用你选择的文档语言。中文、日文和韩文按字符统计,并采用独立的每分钟字符数;混合文本会合并两类时长。常规默读预设为每分钟 250 个词,可以按自己的习惯调整。展开章节时长可找到较长的 H1/H2 章节。这些结果经过四舍五入,只用于安排时间,不代表理解程度;图表和复杂代码可能需要额外投入。

什么时候阅读器比编辑器更合适?

阅读 README 时,通常先要理解项目,再决定是否修改。清晰的概览和要求能够帮助你判断是否继续研究安装细节。阅读学习笔记时,目录方便你回到某个定义并保留上下文。准备课程讲义时,章节估算可以帮助你把预习任务分配到不同的学习时段。

需要改写段落、追踪修订或维护关联资源时,专门的编辑器更合适。格式转换器的用途则是输出另一种文件。本页中粘贴修订稿只会替换阅读副本。需要把正文带到其他工具时,可在本地复制可见文本,无需把私人内容放入分享网址。

隐私、文件限制与链接安全

文档在独立的浏览器 Worker 中本地处理。正文、文件名和搜索词不会提交给转换 API、分析服务或广告提供方。本页沿用现有私密阅读器策略,在这些路由上不加载第三方跟踪脚本。用户文档中的远程图片、字体、媒体和嵌入框架不会自动发起请求。

主动点击外部链接会打开其他网站或邮件应用,请先检查目标地址。仅允许 HTTP、HTTPS、邮件链接和文档内部锚点。选择文件的上限是 10 MiB,渲染还会限制总字符数、嵌套层数、节点数、单行长度和表格单元格数。文件即使未超出大小上限,也可能因为结构过于复杂而不适合手机阅读。

Markdown 显示问题排查

如果解码失败,请使用可信文本编辑器打开原文件,另存为 UTF-8 后重试。把二进制文件改名为 .md 并不会使其成为 Markdown。空文件会显示可恢复的提示,更换文档失败时仍保留之前的阅读副本。遇到复杂度或超时提示时,可以在章节边界拆分文档。

图片缺失通常来自刻意设置的资源访问边界,并不代表文件损坏。选择一个 Markdown 文件不会让浏览器同时获得相邻图片文件夹的权限。过宽的表格可以在自身框架内横向滚动。若图表仍显示源码,或自定义 HTML 布局消失,可检查源码;确实需要特定扩展时,应使用作者推荐的应用。

常见问题

需要安装软件吗?

不需要安装或注册。请使用启用 JavaScript 和 Web Workers 的新版浏览器。关闭 JavaScript 后仍可阅读下方指南。

打开文件会上传吗?

不会。解码、解析、搜索和统计均在本地进行。刷新会清除文档;切换界面语言时,仅在浏览器内存中保留内容。

.md 和 .markdown 都能打开吗?

可以,只要文件包含有效 UTF-8 文本,并符合文件大小和渲染限制。HTML、二进制文件和损坏编码会被拒绝或忽略,不会执行。

为什么图片不显示?

外部图片被阻止,以免联系第三方。单个 Markdown 文件的权限也不足以读取磁盘上的相对图片。占位说明会解释原因。

支持 GitHub 表格和任务清单吗?

支持 GFM 表格、删除线、自动链接和脚注。任务复选框处于禁用状态,阅读清单不会改动源文件。

阅读时间是怎么算的?

将词数除以每分钟词数,将中日韩字符数除以每分钟字符数,再把两类时长相加。总计和各章节分别四舍五入到秒,因此章节显示值之和可能有少量差异。

这是 Markdown 编辑器吗?

这是带有粘贴输入和源码查看功能的阅读器,不提供文件保存、修订跟踪或完整开发环境。维护原文档请使用专门的编辑器。