Markdown上手指南

简介: markdown 是一门很实用的标记语言,若是有HTML 基础学起来会非常快。演示效果均是从typora 展示的,为什么用它,因为它是一个成熟的 md 编辑器!• markdown 所见即所得, 部分还增加了人性化的交互(比如代码高亮)• 支持公式• 支持大部分的拓展语法• 支持主流的流程图渲染


前言


markdown 是一门很实用的标记语言,若是有HTML 基础学起来会非常快。


演示效果均是从typora 展示的,为什么用它,因为它是一个成熟的 md 编辑器!


  • markdown 所见即所得, 部分还增加了人性化的交互(比如代码高亮)
  • 支持公式
  • 支持大部分的拓展语法
  • 支持主流的流程图渲染


温馨提示:


已经会的不用往下面看了,文章的目的是给我们研发组的小伙伴快速上手的。

因为前端这块的文档基本切换到MD来维护,花了点时间录制了一波GIF演示

基础语法


基础语法是支持度最高的,市面上主流的 markdown 解析器基本都支持。


拓展语法需要借助不同的插件或者库实现,通用性没那么强。


注意点 : 所有标记仅支持英文模式(半角)!!

标题


# H1
## H2
### H3
#### H4
##### H5
###### H6



文字强调


粗体


**我是粗体**



粗体


_我是斜体_
*我也是斜体*



着重强调(粗体+斜体)


***我着重的强调,再哔哔我嫩死你***


列表


有序列表


有序列表的格式是:   数字小数点+空格+文本


1. afdslf
2. fsadfae
3. Ewarewr



无序列表


格式: 横线(星号) + 空格 + 文本


- asdklfjsaf 
- fasdfsadf 
* 发水电费卢卡斯
* 发顺丰惹我



列表混合及嵌套


不管是有序列表还是无序列表,都支持多级嵌套,也支持有序无序列表混用。


若是增加一些外部扩展,还支持todo混入


- 测试啊
  - 真的测试啊
  - 你不信啊
    1. 我是三级有序列表
    2. 呵呵哒
  - 唉



外部链接


格式:方括号小括号(链接)


[点击我就跳到百度了](https://www.baidu.com) 



图片引用展示


格式:感叹号+外部链接的格式。 链接支持相对引用!


![closeup photo of computer code screengrab](https://images.unsplash.com/photo-1524666643752-b381eb00effb?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1000&q=80)



水平分割线


格式: 空行 ---


呼叫逗比
---
逗比回应你了


引用


一般你引用了别处的内容,这个就可以用上了

格式: 大于号(>) + 空格 + 内容


>床前明月光
>
>疑是地上霜
>
> - 这是**李白**的诗歌 



行内代码


行内代码的效果通用都是灰色,不能针对语法高亮


格式:反引号+内容+反引号


`module.exports= ()=>{}`



拓展语法


表格


表格的语法也很简单,就是写的多一些,因为列越多写的越多。


默认的列左对齐,也支持设置居中和右对齐, 横杆大于等于3, 列的竖必须闭合才能代表一列!


  • 默认对齐(左对齐) :  :----
  • 居中对齐 : :---:
  • 右对齐: ---:


| 默认左对齐     |       居中对齐       |     右对齐 |
| :--- | :------------------: | -------: |
| 啊水电费萨德 | 阿斯顿六块腹肌阿斯顿 | 发水电费 |
| 1321 | 432 | 654645 |
| 啊水电费萨德 | 阿斯顿六块腹肌阿斯顿 | 发水电费 |
| 1321 | 432 | 654645 |



代码高亮


代码高亮看采用的是什么高亮库了,比如前端这块有用highlightjs 或 prism的。

所以高亮支持语言也得看高亮库是否支持!!


我是纯文本 plain text,因为我没有指定语言


```javascript
// 我是 js 高亮
import vue from 'vue';


# 我是 bash 高亮
ls -l | grep 'haha'


任务列表


这个很实用,就是展示待办事项效果, 算是列表的变种,可以混合使用


  • - [ ] text : 方括号内部空格代指是待办事项
  • -  [x] text : 方括号内部 x代指事项已经完成


- v1版本
  - [x] 用户接口打通
  - [ ] 用户接口合并
    - [ ] 合并重复字段
    - [ ] 呵呵到



文字高亮


格式:双等号+文本+双等号


===听说我要呗高亮了===
==是啊==
==亮瞎眼了==



脚注


这个东西在写文献用的最多


格式:


  • 声明: [^text]: description
  • 引用: hello[^text]


[^李白]: 一个喝酒的诗人
床前明月光[^李白]



删除线


你没看错,这不属于第一个版本的草案的内容,也是后续才有的

格式:两个波浪线+文本+波浪线


~~我给删除了,你看~~



下标


把字缩放,适合用来表现公式类的


H~2~o



mermaid


mermaid 不仅仅可以画流程图,具体可以看mermaid 上手指南




目录
相关文章
五分钟上手 Markdown
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。------百度百科 话不多说,开始发车!总共10个标签,五分钟足矣,毕竟基本没难度。
981 0
Markdown 新手指南
Markdown 新手指南
252 0
Markdown 新手指南
|
Web App开发
我的Markdown的利器——Markdown Here、有道云笔记、iPic
Markdown逐渐成为大家文章编辑的首选,这里推荐两个比较冷门的Markdown工具。 用什么当做Markdown的主力工具? 网上有很多人推荐的Markdown的工具包括专业的Markdown工具,如Mou,macdown等,也有人用编辑器装上插件后就使用,sublime、atom、vs code,一般编辑器可能就无法实时预览。
1376 0
|
Web App开发 移动开发 前端开发
78 款 Markdown 工具
Markdown 是一种易写易读的文本标记语言。本文介绍了编写、查看 Markdown 的78种工具,涵盖桌面端、移动端和 web 端。
387 0
78 款 Markdown 工具
Markdown初体验
关于Markdown update 2015-12-28 学习自:Markdown基础语法整理,Markdown进阶语法整理,Markdown语法说明 -Markdown是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。
889 0
markdown的初体验
简书官方教程:献给写作者的 Markdown 新手指南 其实早就对markdown写作有耳闻了,一直偷懒没有静下来学。 总觉得要把所有的时间精力都放在一件事上才行。
1128 0
|
SQL Shell OLTP
如何基于 Markdown 编写技术文档
需求 文档版本清晰化,充分利用Git 的版本管理能力,轻松对比不同版的修改演进。 减少在文档格式排版上的投入,争取简历上不再有精通word。 充分利用开发者既有工具,减少工具量,少就是多。 工具链 OS:macOS Mojave V10.14.3 IDE:Visual Studio Code Visual Studio Code扩展插件: markdownlint:在写书中如有违规,会在编辑区提示你。
2586 0
|
Linux Windows
Marp —用Markdown编写PPT
Marp —用Markdown编写PPT
249 0
Marp —用Markdown编写PPT
|
Windows
最简单的Markdown教程
Markdown是一种轻量级的标记语言;目标是实现“易读易写”。
214 0
最简单的Markdown教程

热门文章

最新文章