Markdown 语法 · 排错

Markdown 粗体不生效?
为什么看到 ** 而不是加粗

你写了 **粗体**,屏幕上却是星号、而不是加粗的字。加粗的语法是每边两个星号、中间不留空格,但它只有在会渲染 Markdown 的工具里才会变成加粗。

所以其实有两件事要查:你的语法对不对,以及你看它的那个东西到底是不是 Markdown 渲染器。这是常见原因和修法。

常见原因

原因 怎么修
你在纯文本视图里(记事本、不渲染的聊天框) 它显示的是源码;把文字放进 Markdown 渲染器打开
标记里有空格:** 粗体 ** 去掉空格、让它贴着文字:**粗体**
每边只有一个星号:*粗体* 那是斜体;加粗用两个:**粗体**
在代码里(行内代码或代码块) 本来就该字面显示、属于预期
那个 app 就是不支持 Markdown 不是你语法的问题;是那工具的限制

放一起看,那几个语法失误长这样:

粗体:             **像这样**
不加粗(有空格):  ** 像这样 **
不加粗(一个 *):  *像这样*   是斜体
粗体+斜体:         ***像这样***

最大的一个:你到底在不在 Markdown 渲染器里

加粗不生效最常见的原因不是打错字,而是你看到的就是生文本。记事本、一个纯文本框、以及不少聊天和表单输入框都不渲染 Markdown,所以它们把 **粗体** 原样显示。那不是坏了,只是个纯文本视图。想看到排版,把文字放进 Markdown 编辑器或查看器打开。这个看 md 文件怎么打开

如果一个地方生效、另一个不生效

有时你的 **粗体** 在一个 app 里渲染正常、在另一个里显示星号。这种时候,你的语法是对的,只是第二个工具不渲染 Markdown(或只渲染一部分)。你文字里没什么要改的;你需要的是一个支持 Markdown 的工具。如果你其实是想**故意**显示字面的星号,那是转义,看 Markdown 转义怎么写

用 NoteLoom 确认你的语法

最快把这事定下来的办法,就是自己把文字渲染一遍。NoteLoom 是个在浏览器里读写本地 .md 文件的编辑器:在 source 视图里打或贴你的 **粗体**,livereading 视图立刻显示成加粗。如果那里出成了加粗,你的语法就对,任何还显示星号的工具只是没渲染 Markdown。

先说清边界:NoteLoom 没有任何 AI,也改不了别的 app 怎么显示你的文字。它渲染并存回你本地的 Markdown,让你确认自己这边是对的。

用起来:用 Chrome / Edge / Arc 打开 app.noteloom.cc,挂载一个本地文件夹,在 source 视图里写、看 live 视图的结果。直接存回本地,不上云、不用账号。

FAQ

我的 Markdown 粗体为什么不生效(看到 ** 而不是加粗)?
每边两个星号是加粗,**像这样**,但只在会渲染 Markdown 的工具里。如果你看到的是星号,要么你在不渲染 Markdown 的纯文本视图里,要么有个小语法失误、比如标记里带了空格。
加粗用一个星号还是两个?
两个。**粗体** 是加粗;单个 *词* 是斜体;***三个*** 两个都占。每边只用一个,得到的是斜体、不是加粗。
空格为什么会破坏加粗?
Markdown 要星号紧贴文字。** 粗体 **(开头星号后、或结尾星号前有空格)不会渲染成加粗;**粗体** 才行。
我的加粗在一个 app 生效、另一个不生效,为什么?
不是每个工具都渲染 Markdown,有的只支持一部分。如果 **粗体** 在一处渲染、在另一处显示星号,你的语法没问题,是第二个工具没渲染 Markdown。那是 app 的限制、不是你文字的错。
怎么确认我的加粗语法对?
把它放进一个带实时预览的 Markdown 编辑器。如果那里显示成加粗,你的语法就对,任何还显示星号的工具只是没渲染 Markdown。NoteLoom 的 live 和 reading 视图会渲染它,你一眼就能确认。
手机或 Safari 能用 NoteLoom 弄吗?
目前不行。NoteLoom 依赖浏览器的 File System Access API,当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器;Firefox、Safari 和手机端暂不支持。

一秒确认你的加粗能渲染

用 Chrome / Edge / Arc 打开 NoteLoom,挂载一个本地文件夹,在 source 视图里打 **粗体**、看 live 视图里它变加粗。直接存回本地,不用装软件,也不用注册账号。

打开 NoteLoom 试试