Markdown and Git for Collaborative Writing
Session 1, 2023-08-17
Peter Kaminski - kaminski@istori.com
- WYSIWYG vs. Markup Language
- Markdown - a simple text formatting language
- Git - a distributed version control apparatus
- GitHub - a centralized Git "forge"
- Massive Wiki
- Tools
Markdown and Git for Collaborative Writing
WYSIWYG vs. Markup Language
WYSIWYG
Markup + Rendering
➡
- Microsoft Word
- Apple Pages
- Google Docs
- HackMD
- Obsidian
- Your Favorite Text Editor
Various editors
and renderers
Markdown
A simple text formatting language
Bold, Italic
Make _some text italic_
Make **some text bold**
Make some text italic
Make some text bold
➡
Markdown
A simple text formatting language
Bullets
- One Bullet
- Another Bullet
- One Bullet
- Another Bullet
➡
1. One Bullet
1. Another Bullet
- One Bullet
- Another Bullet
➡
Markdown
A simple text formatting language
Headers
# Header 1
## Header 2
### Header 3
Header 1
Header 2
Header 3
➡
Markdown
A simple text formatting language
Recap
# Document Title (Header 1)
## Section Title (Header 2)
- One bullet
- Another bullet
- A third bullet
This sentence has some **bold text** and _italic text._
Markdown
A simple text formatting language
Resources
Git
A distributed version control apparatus
Conceptual Diagram
Git
A distributed version control apparatus
Merging
Four score and seven years
forth on this continent, a
new nation, conceived in
Liberty, and dedicated to the
proposition that all men are
created equal.
Four score and seven years
ago our fathers brought
forth on this continent, a
new nation, conceived in
proposition that all men are
created equal.
Four score and seven years
ago our fathers brought
forth on this continent, a
new nation, conceived in
Liberty, and dedicated to the
proposition that all men are
created equal.
➡
➡
A
B
Merged
Git
A distributed version control apparatus
Resources
GitHub
A centralized Git "forge"
Case Study - Obsidian Settings Manager
Tools
- Your Favorite Text Editor (plain text files)
- HackMD
- Obsidian
- Pulsar
- Typora
- Forges: Codeberg, GitHub, GitLab, BitBucket
- Self-hosted forges: Forgejo, Gitea, Gitolite