Markdown

    技术2022-07-11  72

    什么是Markdown常用语法转义字符语法分解Vim的markdown相关插件

    什么是Markdown

    Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。目前大部分博客网站都支持markdown文本格式,如知乎的专栏文章,本文即通过markdown编写。它可以保证在多个网站之间转移编辑文档时,文本格式不被破坏,易于存储,可以实现版本控制。

    常用语法

    markdown流程图: https://www.jianshu.com/p/b421cc723da5

    一图说明markdown语法规则,可以说相当简单了:

    中划线: ~~<line>~~ 结果如下: <line>

    转义字符

    \$ ---- $ \> ---- > \< ---- <

    语法分解

    refer:https://www.jianshu.com/p/191d1e21f7ed/

    使用Markdown时,可以简单的使用关键词 “$$” 或者一对 “$$” 插入Latex语法的数学公式。如: $$ -(\frac{\hbar^2}{2m}) \cdot \frac{\delta \Phi ^2}{\delta x^2}+ V \Phi = i\hbar \frac{\delta \Phi}{\delta t} $$

    − ( ℏ 2 2 m ) ⋅ δ Φ 2 δ x 2 + V Φ = i ℏ δ Φ δ t -(\frac{\hbar^2}{2m}) \cdot \frac{\delta \Phi ^2}{\delta x^2}+ V \Phi = i\hbar \frac{\delta \Phi}{\delta t} (2m2)δx2δΦ2+VΦ=iδtδΦ

    有的网站不支持markdown的latex公式显示,该公式显示如图所示:

    插入图片

    本地图片:

    ![blockchain](./pic/pic1.jpg)

    网络图片:

    ![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy)

    相较本地图片,网络图片更加方便,容易迁移。这需要稳定的图床,现在大多数网站如微博等都加入了防盗链,使用腾讯云的COS作为图床是个不错的选择: https://blog.csdn.net/a201577f0546/article/details/80146350

    插入代码 ``` code... code... code... ```

    如上的代码中,代码自身就带有反引号,需要将反引号个数增加至4个,参考:https://www.jianshu.com/p/d6ca2d4dfaab

    Vim的markdown相关插件

    Neovim较vim的优势:由于某几个插件的特殊性(Markdown Perview),我最终还是选择了Neovim作为我的主力编辑器。

    安装vim-markdown插件,是一个Markdown语法高亮插件。其提供了针对Markdown的语法高亮,段落折叠,查看目录,段间跳转等功能。

    "查看所有配置建议 :help vim-markdwon [[ "跳转上一个标题 ]] "跳转下一个标题 ]c "跳转到当前标题 ]u "跳转到副标题 zr "打开下一级折叠 zR "打开所有折叠 zm "折叠当前段落 zM "折叠所有段落 :Toc "显示目录 vim-markdown-toc 是一个自动在当前光标生成目录的插件。 "在当前光标后生成目录 :GenTocMarked "更新目录 :UpdateToc "默认保存时自动更新目录,如果需要取消储存时自动更新目录 let g:vmt_auto_update_on_save = 0 markdonw-preview.nvim(Neovim)和 markdown-preview.vim (Vim) 可以通过浏览器实时预览Markdown 文件。并可以借助浏览器的打印功能导出PDF文档。两个插件为同一个作者的作品,但是Neovim版本较新,更加完善,附带了Latex预览,Mermaid甘特图,Plantuml UML图等等一系列功能。这个插件安装非常卡,放了一晚上才安装好;中间安装了几次都无法打开浏览器预览markdown文件,在checkhealth里说是缺失可执行文件。 " 安装插件 Plug 'iamcco/markdown-preview.nvim' " 打开/关闭预览 :MarkdownPreview " 指定浏览器路径 let g:mkdp_path_to_chrome = "path/of/chrome" " 指定预览主题,默认Github let g:mkdp_markdown_css=''

    现在感觉使用vscode作为md预览更好,安装插件Markdown All in One, Markdown Preview Enhanced两个插件,按ctrl-k v即可在另一侧打开预览。

    Processed: 0.016, SQL: 11