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 上手指南




目录
相关文章
|
7月前
|
Web App开发 移动开发 搜索推荐
常见的Markdown在线编辑器
在线Markdown编辑器提供了更加稳定和流畅的用户体验。用户无需下载安装任何软件,只需打开浏览器,即可在任何设备上轻松使用这款编辑器,实现随时随地的写作。基于HTML5的在线Markdown编辑器可实现即时的编辑和预览功能
117 2
|
Rust JavaScript Docker
提升 Markdown 文档协作:Let's Markdown介绍与部署
Let's Markdown 是一个开源项目,旨在简化 Markdown 文档的创建、编辑和共享。快速、最小的网络编辑器,使标记编辑协作,每个人都可以访问。它提供了一套工具和功能,使 Markdown 文档的处理变得更加轻松和高效。使用Rust和React.js构建。有关详细信息,请参阅GitHub仓库。
354 3
提升 Markdown 文档协作:Let's Markdown介绍与部署
|
搜索推荐 程序员 PHP
Markdown新手入门必知必会
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
135 0
Markdown新手入门必知必会
|
Windows
最简单的Markdown教程
Markdown是一种轻量级的标记语言;目标是实现“易读易写”。
204 0
最简单的Markdown教程
|
运维 应用服务中间件 nginx
在线编写Markdown
在线编写Markdown
208 0
|
自然语言处理 前端开发 JavaScript
开发一个 vscode 插件,提升 markdown 排版可读性🌿
开发一个 vscode 插件,提升 markdown 排版可读性🌿
463 0
|
JavaScript
Markdown 写文档做笔记的利器
Markdown 写文档做笔记的利器
Markdown 写文档做笔记的利器
MarkDown入门MarkDown介绍
MarkDown入门MarkDown介绍
205 0