- [[markdown]]
- Technical Writing Courses This collection of courses and learning resources aims to improve your technical documentation. Learn how to plan and author technical documents. You can also learn about the role of technical writers at Google.
- On Typesetting Engines: A Programmer's Perspective - 排版引擎纵谈:程序员的视角
- 中文技术文档的写作规范 - ruanyf
- 中文文案排版指北 - sparanoid
- 中文文档编写规范 - creator-docs
- 语种名称代码
- 以往,人们常用
zh-CN
表示在中国大陆地区使用的中文,也就是简体中文,用zh-TW
表示在台湾地区使用的中文,也就是繁体中文。但是,这种表示法很不完善 - 目前,语言的标签表示法的国际标准是RFC 4646,名称是《Tags for Identifying Languages》,简单说,这个文件规定,一种语言的标签应该按照如下方式排列:
- language-script-region-variant-extension-privateuse
- language:这部分就是 ISO 639 规定的代码,比如中文是 zh
- script:表示变体,比如简体汉字是 zh-Hans,繁体汉字是 zh-Hant
- region:表示语言使用的地理区域,比如 zh-Hans-CN 就是中国大陆使用的简体中文
- variant:表示方言
- extension-privateus:表示扩展用途和私有标识。
- 一般约定,language 标签全部小写,region 标签全部大写,script 标签只有首字母大写。不同标签之间用连字号 - 链接
- 中文相关标签
- zh-Hans 简体中文
- zh-Hans-CN 大陆地区使用的简体中文
- zh-Hans-HK 香港地区使用的简体中文
- zh-Hans-MO 澳门使用的简体中文
- zh-Hans-SG 新加坡使用的简体中文
- zh-Hans-TW 台湾使用的简体中文
- zh-Hant 繁体中文
- zh-Hant-CN 大陆地区使用的繁体中文
- zh-Hant-HK 香港地区使用的繁体中文
- zh-Hant-MO 澳门使用的繁体中文
- zh-Hant-SG 新加坡使用的繁体中文
- zh-Hant-TW 台湾使用的繁体中文
- 以往,人们常用
- Slidev Presentation Slides for Developers
- tldraw: A tiny little drawing app. https://tldraw.com/
- excalidraw: Virtual whiteboard for sketching hand-drawn like diagrams. Go to excalidraw.com to start sketching.
- diagrams.net/draw.io is an open source technology stack for building diagramming applications, and the world’s most widely used browser-based end-user diagramming software.
- drawio-desktop is a diagrams.net desktop app based on Electron.
- Draw.io Integration: This extension integrates Draw.io into VS Code.
- flowchart.fun ⿻: Easily generate flowcharts and diagrams from text ⿻. Running at https://flowchart.fun
- Wireflow is free, online and open source tool for creating beautiful user flow prototypes. No Photoshop skills required! Official Website: Wireflow.co
PlantUML is an open-source tool allowing users to create UML diagrams from a plain text language. The language of PlantUML is an example of a Domain-specific language. It uses Graphviz software to lay out its diagrams. It has been used to allow blind students to work with UML. PlantUML also helps blind software engineers to design and read UML diagrams
- 可安装插件
Markdown Preview Enhanced
预览:>Markdown: Open preview to the Side
- 在预览界面右键选择
Chrome->PDF
可以导出 pdf 文件 - 如果使用插件不支持的
plantuml
语法,需要安装 Graphviz
![alternative text](http://www.plantuml.com/plantuml/proxy?src=https://raw.github.com/plantuml/plantuml-server/master/src/main/webapp/resource/test2diagrams.txt)
- 可将
src
后面的值替换为自己的plantuml
文件的 url
Graphviz is open source graph visualization software. Graph visualization is a way of representing structural information as diagrams of abstract graphs and networks. It has important applications in networking, bioinformatics, software engineering, database and web design, machine learning, and in visual interfaces for other technical domains.
- miloyip/graphvizuml 使用 Graphviz 绘画 UML 图
- Using Graphviz to generate automated system diagrams
- 语雀Graphviz教程 包学包会
- gravizo: How to include graphviz graphs in github README
- docusaurus Easy to maintain open source documentation websites. https://docusaurus.io
- pandoc a universal document converter
- If you need to convert files from one markup format into another, pandoc is your swiss-army knife.
- Awesome README Elements in beautiful READMEs include, but are not limited to: images, screenshots, GIFs, text formatting, etc.