Markdown 写作入门:六个语法覆盖九成场景

举报
yd_234737719 发表于 2026/11/11 05:14:03 2026/11/11
【摘要】 README、技术博客、笔记都离不开 Markdown。本文只讲最常用的六个语法,十分钟上手。

写 README、记笔记、发技术博客,Markdown 都是标配。它语言极小,常用语法六个就够,其余用到再查。

一、标题与段落

井号加空格就是标题:# 一级标题 到 ###### 六级。段落之间空一行,同段内想强制换行在行尾补两个空格。写文档时标题层级不要跳级,一级标题全篇一个,结构清晰比什么都重要。

二、强调与列表

星号包起来是强调:*斜体*、**粗体**、***粗斜体***。无序列表用短横线加空格,有序列表用数字加点,嵌套缩进两个空格。任务列表是方括号写法:- [ ] 未完成、- [x] 已完成,做周报和 TODO 特别顺手。

三、链接、图片与代码

链接:[显示文字](https://example.com);图片在前面加感叹号:![描述](img.png)。行内代码用反引号包裹,代码块用三个反引号并在首行标注语言,语法高亮就出来了。引用用大于号:> 引用内容,适合放注意事项。

四、表格与分隔线

表格用竖线画:表头一行、下面一行短横线(可用冒号控制左/右/居中对齐),再往下就是数据行。三个短横线单独一行是分隔线,用于章节切换。

小结:标题、强调、列表、链接、代码块、表格,这六个语法覆盖九成写作场景。剩下的问题交给编辑器的实时预览,写两篇就熟了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。