# 书屿 Markdown 字符核对：分清代码、表格与普通正文

语言：zh-CN
原文：[书屿 Markdown 字符核对：分清代码、表格与普通正文](<https://allluckly.cn/guides/nasbook-markdown-literal-code-table-check/>)
中文：[中文 HTML](<https://allluckly.cn/guides/nasbook-markdown-literal-code-table-check/>)
English: [English HTML](<https://allluckly.cn/en/guides/nasbook-markdown-literal-code-table-check/>)
发布于: 2026-11-04T00:00:00+08:00
内容更新于: 2026-11-04T00:00:00+08:00
署名：Bison

用短小Markdown样本核对井号、星号、反引号、竖线与列对应，区分原始标记和渲染结果，避免把示例命令当成操作指令。

Markdown文件可以被当作原始文字阅读，也可以经过某种语法解析后显示，两种路径不能混为一谈。书屿公开支持Markdown，本篇不预设它采用完整网页渲染，而用自己的短样本检查文字身份、代码边界和表格关系。目标是判断资料在当前路径中是否容易准确阅读，不要求应用执行命令或自动补齐某种扩展语法。

## 准备包含易混符号的小样

用自己熟悉的文本编辑器保存一份UTF-8的MD文件，保留原件。小样同时放普通段落、带井号标题、一段代码和两行表格，所有内容都由自己编写，不混入私人配置。下面样本只供查看与核对，代码行不会要求你运行任何命令。先在编辑器确认每个符号、空格与换行确实存在，再导入副本；不要拿经过聊天平台重新排版后的内容作为唯一参照，否则原始标记可能已经改变。

````
# Sample
Use * as a literal symbol.

```text
# This line belongs to the example.
item_a | item_b
```

| Item | Count |
| --- | --- |
| Amber | 2 |
| Blue | 7 |
````

## 先判定当前看到的显示路径

打开后看井号、反引号和表格分隔行是否仍直接可见，并与编辑器比较。若标记保留，先按原始文本路径理解，不把它叫成排版失败；若被解析为标题或代码区域，则继续核对结果是否对应。不同路径可适合不同任务，关键是事先知道自己在看什么。记录应用版本与实际表现，不凭格式名称推出必有语法高亮、网页预览或可点选目录。后续所有检查都沿当前路径进行，不需要寻找没有核实的模式切换按钮。

## 检查星号与反引号的内容身份

逐处看星号是作者要展示的字符，还是用来标记强调的语法；反引号中的内容也可能要求按字面读。若资料讨论通配符或乘号，少一个星号可能改变示例，不能只看句子大概通顺。源码路径中保留语法字符正常，但应能判断它们包围哪一段。渲染路径中则检查字面符号是否被错误吞成强调。必要时回编辑器读取，不在唯一原件上随意加转义符修补；修改副本也应记录改了什么。

## 代码块只核对不执行

找到代码围栏的起点和终点，检查里面的井号有没有被误当书籍标题，缩进与换行是否可辨。自动换行只是屏幕显示变化，不代表原代码增加了真实换行；复制之前回原始文件确认。示例中的文件名、参数与管道符按字符核对，不将介绍性文字和代码连成一条命令。书屿承担阅读而非代码执行，本练习也不要求运行。若资料用于开发，最终应在合适编辑器里核对代码原件，不能凭阅读页截图抄写后直接使用。

## 按表头核对每行列关系

选择两条取值不同的记录，按第一列表名与第二列数量分别读回，防止窄屏折行后把上下两行数字配错。原始文本路径中的竖线和分隔行需要自己识别；若已经显示成表格，也不能只看外框整齐。表格属于常见扩展语法，不应从支持Markdown推断所有扩展一致。单元格里的竖线可能有专门写法，先查作者采用的语法约定，不擅自切成新列。关系不清时回编辑器或可靠渲染参照，优先保证数据含义。

## 区分相对链接与正文内容

资料中的链接文字、目标地址和本地资源路径是不同字段，当前阅读方式未必把它们做成可点击入口。先核对目标文本是否保留，不因无法打开就说整段内容缺失。相对路径需要原目录关系，移动单个MD可能使图片或链接失去参照，但不会自动证明正文解析错误。需要查看外部网页时按自己信任的方式另行访问，注意当前资料是否只保存地址而没有页面内容。不要把未读取的链接目标当作已经随这本资料离线保存。

## 选择保留源码或版面的副本

若任务是检查语法和示例字符，保留原MD并在适当编辑器辅助；若是阅读数据表和配图，可用熟悉工具另存合法PDF或合适的可读副本。转换后仍核对两行数据、代码首末行和特殊符号，不因为版面漂亮就认为字符无误。注明生成方式及原文件身份，别改后缀冒充转换。新副本的页码与定位不同，旧笔记用章节和短句重新关联，不假定自动同步。原始资料与便于阅读的版本可以并存，各自用途写清。

## 完成检查并处理常见误会

完成标准是显示路径清楚、特殊字符可核对、代码边界明确、两行列关系正确、链接范围不误认。为什么看到井号不一定有错？可能正在阅读原始标记。为什么外框成表仍要复查？数字可能错行或漏格。为什么代码自动折行不等于原文件多一行？屏幕排版与源字符不同。保存小样与结果用于反馈，别加入真实密码或服务器地址。某项不适合当前路径时改用可靠参照，不编造应用已经具备的完整渲染或运行能力。

## 相关教程与资料

[书屿文档阅读：整理 Markdown、HTML 与 Office 文档](<https://allluckly.cn/guides/nasbook-document-reading/>)、[书屿 TXT 段落检查：分清手动折行与真正分段](<https://allluckly.cn/guides/nasbook-txt-hard-linewraps/>)。

资料核对：2026 年 11 月 4 日，[Apple 公开版本查询](<https://itunes.apple.com/lookup?id=6766198898&country=cn>)显示书屿 1.1.3，最低 iOS / iPadOS 15.6。能力范围以[官方 App Store 说明](<https://apps.apple.com/cn/app/id6766198898>)与安装版本为准。本文提供可自行执行的阅读与检查方法，未声明真机或私人服务器逐项实测；人工清单、外部工具与实际可见入口分别说明，源码观察不等于所有发行路径已经验证的能力。

语法概念参考[CommonMark 规范](<https://spec.commonmark.org/0.31.2/>)与[GitHub 表格扩展定义](<https://github.github.com/gfm/#tables-extension->)；标准说明语法关系，不是书屿具体渲染功能的承诺。