Markdown 基本语法
<style>.artBox { font-size: 18px; }
.artBox p { margin: 12px 0; }
.tMid { text-align: center; }
</style>
<div class="artBox">
<h1 class="tMid">Markdown 基本语法</h1>
<p><strong>【主意】Markdown 语法用到的符号均为小角符号!</strong></p>
<h2>一、标题</h2>
<p>【语法】<code># 标题文本</code></p>
<p>标题共有 6 种类型,称为一级标题、二级标题、……六级标题,多少级就用多少个 # 号,最后一个 # 号和标题文本之间<strong>必须有一个空格</strong>。例:</p>
<p><code># 一级标题</code>等同于 <code><h1>一级标题</h2></code></p>
<p><code>## 二级标题</code> 等同于 <code><h2>二级标题</h2></code></p>
<h2>二、段落</h2>
<p>【语法】<code>空白行</code></p>
<p>在需要创建段落的地方留一个空白行,没有任何内容。对标 <code><p></code> 标签。</p>
<h2>三、换行</h2>
<p>【语法】<code>句末加两个或两个以上空格</code></p>
<p>如果自然文本行的末尾有两个或两个以上的空格,则视为换行。等效于 html 的 <code><br>标签</code> 标签。</p>
<h2>四、强调</h2>
<h3>(一)粗体</h3>
<p>【语法】<code>**粗体文本**</code></p>
<p>需要加粗的文本两边都用双 * 号包裹,文本和 * 号之间不能有空格。对应于 <code><strong></code> 标签。</p>
<h3>(二)斜体</h3>
<p>【语法】<code>*斜体文本*</code></p>
<p>需要渲染为斜体的文本两边用单个 * 号包裹,文本和 * 号之间不能有空格。对应于 <code><em></code> 标签。</p>
<h3>(三)粗斜体</h3>
<p>【语法】<code>***粗斜体文本***</code></p>
<p>需要渲染为粗体+斜体的文本两边用三个 * 号包裹,文本和 * 号之间不能有空格。对应于 <code>strong</code> 和 <code><em></code> 标签的嵌套结构。</p>
<h2>五、块引用</h2>
<p>【语法】<code>>引用的文本</code></p>
<p>块引用对应于 html 种的 <code>blockquote</code> 标签,支持多级块引用嵌套,多少级就使用多少个符号 > 。在 html 中,默认情况下,块引用渲染的效果是文本缩退,但也可以通过 CSS 设置为其他样式。</p>
<h2>六、列表</h2>
<h3>(一)有序列表</h3>
<p>【语法】<code>x. 项目名称</code></p>
<p>x 为阿拉伯数字,紧跟着一个 . 号,<strong>. 号后面必须要有一个空格都然后才是项目名称</strong>。</p>
<h3>(二)无序列表</h3>
<p>【语法】<code>- 项目名称</code> 或 <code>* 项目名称</code> 或 <code>+ 项目名称</code></p>
<p>符号 <code>- * +</code> 任选其一,<strong>符号和项目名称之间必须有一个空格</strong>。</p>
<p>【注】列表可以嵌套。父层和子层之间,父层不退格,子层用 Tab 键退格。一些所见即所得的编辑器在结束子层时需要打两次回车键。语法举例如下:</p>
<pre>1. 父层项目一
2. 父层项目二
1. 子层项目
2. 子层项目二
3. 父层项目三
</pre>
<h2>七、代码</h2>
<p>【语法】<code>`代码文本</code></p>
<p>所谓代码,对应于 html 标签 <code><code></code>,属行内标签,代码文本的前后用反引号 ` 包裹。若需要在代码中显示反引号,请用反引号转义反引号,也就是一对反引号连续写在一起,``。</p>
<h2>八、分隔线</h2>
<p>【语法】<code>---</code> 或 <code>___</code> 或 <code>***</code></p>
<p>符号 <code>-_*</code> 任选其一,对表 html <code><hr></code> 标签,建议文档中使用前后一致的符号表示分割线。不论使用哪一种符号,至少要三个连续的相同符号才能渲染分隔线。</p>
<h2>九、链接</h2>
<p>【语法】<code>[链接名称](链接地址 "弹出文本")</code></p>
<p>即锚,对应于 html 标签 <code><a></code>。链接名称写在中括号内,链接地址和弹出文本写在小括号内,其中弹出文本可选,若有,需要使用双引号包裹起来,且和链接地址间隔一个空格。</p>
<h2>十、图片</h2>
<p>【语法】<code></code></p>
<p>语法结构与锚高度相似,唯一不同的是前面有一个小角感叹号。</p>
<h2>十一、转义字符</h2>
<p>【语法】<code>\待转义符号</code></p>
<p>因为 Markdown 语法中使用一些符号作为内置语法关键字,要显示这些符号就需要转义。除反引号 ` 使用自身转义自身外,其余符号均使用\ 进行转义,符号 \ 和待转义符号之间<strong>不要留有空格</strong>。</p>
<h2>十二、表格</h2>
<p>【语法】</p>
<pre>|姓名|性别|年龄|
|:---:|:---:|---:|
|李大二|男|21|
|张小三|女|19|
</pre>
<p>具体操作:先制作表头,用管道符号 <code>|</code> 表示列;然后制作各列的对齐方式,<code>---</code> 或 <code>:---</code> 表示左对齐,<code>:---:</code> 为居中,<code>---:</code> 为右对齐;最后制作各行表格内容。</p>
<h2>十三、内嵌HTML代码</h2>
<p>Markdown 的语法非常有限,所以允许嵌入 html 代码以实现更为精细的渲染效果,例如给文本添加前景色,例如:</p>
<p><code><span style="color: red;">红色文本</span></code></p>
<p><code><p style="text-align: center;">居中文本</p></code></p>
</div> 本文使用 Typora 编辑器按照 Markdown 语法进行编写,然后复制为 html 代码再加上一个壳后发布到这里。内容凭个人理解进行组织,如果有误,敬请各位指正。 使用 Markdown 写一篇文档无法就是这样的代码结构:
# 文章标题
段落一
段落二
## 二级标题1
段落三
段落四
## 二级标题2
段落五
段落N其他修饰,如文本加粗、斜体,分隔线,等等,在适当的地方加入加入适当的修饰语法即可。文章的标题层级则可以根据需要进行设计,段落还是换行可以根据需要而定。感觉吧,使用 Markdown编写文档还是很方便的。
这个基本语法说明非常有用,学习了{:4_187:} 谢谢马老师讲授Markdown 语法,我们学习、使用 Markdown 写文档有了方向与抓手{:4_180:} 马黑黑 发表于 2026-2-9 21:10
本文使用 Typora 编辑器按照 Markdown 语法进行编写,然后复制为 html 代码再加上一个壳后发布到这里。内容 ...
什么是Typora 编辑器呀?请马老师介绍一下{:4_172:} 杨帆 发表于 2026-2-10 15:12
什么是Typora 编辑器呀?请马老师介绍一下
Markdown 文档所见即所得的编辑器,现在是收费软件,不建议使用,因为同类产品中免费的很多。
推荐的编辑器是 Typedown,在Windows应用商店可以下载安装,新版本 1.2.18.0 已经可以比肩 Typora,甚至更好用,界面和微软的新记事本相似,启动速度和记事本一样,可以将 Markdown 文档转为TTP等,可以复制内容为 HTML 等,非常方便。缺点是它目前只能用于 Windows 平台,不像 Typora 可以跨平台使用。 杨帆 发表于 2026-2-10 15:10
谢谢马老师讲授Markdown 语法,我们学习、使用 Markdown 写文档有了方向与抓手
语法很简单的,绝大多数人最多花十分钟就可以学会。 感谢马老师分享,祝您小年快乐!
https://www.yueyijyw.com/data/attachment/forum/202602/10/160836fyylx6h86iztkt3x.jpg
本帖最后由 杨帆 于 2026-2-10 20:23 编辑
马黑黑 发表于 2026-2-10 16:21
Markdown 文档所见即所得的编辑器,现在是收费软件,不建议使用,因为同类产品中免费的很多。
推荐的 ...
谢谢马老师介绍与推荐~{:4_180:}
刚从联想应用商店下载Typora 编辑器,是付费软件呢{:4_173:}
马黑黑 发表于 2026-2-10 16:21
语法很简单的,绝大多数人最多花十分钟就可以学会。
是,不过学会到熟练还是有距离呢,祝马老师小年快乐{:4_176:} 杨帆 发表于 2026-2-10 20:18
谢谢马老师介绍与推荐~
刚从联想应用商店下载Typora 编辑器,是付费软件呢
如果不考虑升级问题,可以下载它的最后一个免费版本,然后在设置里禁止升级;
如果想永久白嫖,也有方法,例如永远是试用的第一天,网上找找。 杨帆 发表于 2026-2-10 20:27
是,不过学会到熟练还是有距离呢,祝马老师小年快乐
感觉应该不难吧 马黑黑 发表于 2026-2-11 14:02
感觉应该不难吧
是,不难,主要是熟悉{:4_173:} 马黑黑 发表于 2026-2-11 14:02
如果不考虑升级问题,可以下载它的最后一个免费版本,然后在设置里禁止升级;
如果想永久白嫖,也有方 ...
呵呵,谢谢老师,办法不错呢{:4_180:} 杨帆 发表于 2026-2-11 16:14
是,不难,主要是熟悉
如果有使用 Markdown 写作需求,熟悉不是个事 杨帆 发表于 2026-2-11 16:16
呵呵,谢谢老师,办法不错呢
办法总比困难多 马黑黑 发表于 2026-2-11 19:28
如果有使用 Markdown 写作需求,熟悉不是个事
是,的确如此{:4_173:} 杨帆 发表于 2026-2-11 19:44
是,的确如此
{:4_181:}
页:
[1]