像写程序一样写文档, 像写代码一样写markdown。
本教程推荐使用 Visual Studio Code。若你只想学习markdown基本语法,可以使用有道云笔记、大象笔记等在线笔记软件,或者其它支持预览markdown渲染效果的本地文本编辑器,学习文件:"markdown basic.md"的内容即可。否则请先安装Visual Studio Code。
如果你还在犹豫,可以先用浏览器打开out/markdown tutorial.html文件,你看到效果就是本教程的文件生成的HTML文档效果。有目录、有跳转、有标题、有小节,作为一个简单、方便的文档写作工作还是值得学习的。
- 官网下载地址:https://code.visualstudio.com
- 可以根据自己使用的环境下载对应的版本,Stable稳定版,Insiders内测版;
- 记住vs code核心快捷键:
ctrl+shift+p
(打开命令面板)。你可以试一下效果,用vs code打开本文件,然后使用快捷键ctrl+shift+p
,在弹出的命令面板中输入markdown
,注意不要按Enter键,vs code 会自动搜索出相关的命令,在提示的命令中找到markdown: Open Preview to the Side
。查看vs code 内建的markdown预览效果。
- 刚装好的vs code只能预览单个markdown文件的渲染效果,我们优先查看文件"markdown basic.md"。
- 学习Markdown扩展语法先查看"MPE prepare.md"。按说明安装Markdown Preview Enhanced插件。
- 安装插件后打开文件"markdown tutorial.md"即可查看完整的教程,打开文件后右键选择"Markdown Preview Enhanced: Open Preview to the Side"可以看到使用Markdown Preview Enhanced预览的效果。本教程完全参照MPE扩展语法写成。