Markdown and Command Line Interfaces

Markdown and Command Line Interfaces

Introduction to Markdown

Markdown is a simple markup language that allows you to write structured documents using plain text format. Imagine writing notes in a notebook, but with special rules that make your writing convertible into neat and structured documents.

Why is markdown so useful? Just like you write WhatsApp messages with bold text or italic text, markdown allows you to format text in a way that's easy to read even before it's converted to the final format. It's like giving instructions to the computer about how text should be displayed, without having to bother with complicated formatting buttons.

Basic Markdown Syntax

Here are examples of the most commonly used markdown syntax. Notice how each symbol has a special meaning, like the hash symbol for headings:

basic-syntax.md

# Heading Level 1## Heading Level Two### Heading Level Three**Bold text***Italic text*~~Strikethrough text~~> Blockquote for important quotes1. First ordered list item2. Second ordered list item3. Third ordered list item- Unordered list item- Another item- Last item[Link text](https://example.com)![Alt text](image.jpg)`inline code````python# Code blockdef hello_world():  print("Hello, World!")```---| Column 1 | Column 2 | Column 3 ||----------|----------|----------|| Data A   | Data B   | Data C   || Data D   | Data E   | Data F   |

markdown-workflow.sh

# Create new markdown filetouch document.md# Edit with text editornano document.md# Convert to HTML using pandocpandoc document.md -o document.html# Convert to PDFpandoc document.md -o document.pdf# Preview in browseropen document.html

navigation-commands.sh

# Display current working directorypwd# List directory contentslsls -l    # detailed formatls -la   # including hidden files# Change directorycd /home/user/documentscd ..    # go up one levelcd ~     # go to home directorycd -     # return to previous directory# Create new directorymkdir new_projectmkdir -p project/src/components  # create directory hierarchy

file-operations.sh

# Copy filescp source.txt destination.txtcp -r source_folder/ destination_folder/# Move or rename filesmv old_name.txt new_name.txtmv file.txt /path/to/new/location/# Delete filesrm unwanted_file.txtrm -rf unwanted_folder/  # delete directory and its contents# View file contentscat file.txt        # display entire contentshead -10 file.txt   # first 10 linestail -10 file.txt   # last 10 linesless file.txt       # view with navigation

markdown-cli-workflow.sh

# Setup markdown projectmkdir my-documentationcd my-documentation# Directory structuremkdir -p {src,build,images,assets}# Create markdown filestouch src/index.md src/getting-started.md src/api-reference.md# Automate build with scriptcat << 'EOF' > build.sh#!/bin/bashecho "Building documentation..."# Convert all .md files to .htmlfor file in src/*.md; do  basename=$(basename "$file" .md)  pandoc "$file" -o "build/$basename.html" --standalone --css=style.css  echo "Converted: $file -> build/$basename.html"doneecho "Build completed!"EOF# Make script executablechmod +x build.sh# Run build./build.sh

markdown-tools.sh

# Install pandoc (universal document converter)# Ubuntu/Debian:sudo apt-get install pandoc# macOS with Homebrew:brew install pandoc# Install markdown linternpm install -g markdownlint-cli# Check markdown syntaxmarkdownlint *.md# Install markdown preview toolnpm install -g markdown-preview# Preview markdown in browsermarkdown-preview README.md# Convert markdown to various formatspandoc input.md -o output.pdfpandoc input.md -o output.docxpandoc input.md -o output.epub# With custom templatepandoc input.md -o output.html --template=custom.html

best-practices.sh

# Git workflow for markdown documentationgit initgit add README.mdgit commit -m "Initial documentation"# Automation script for documentationcat << 'EOF' > update-docs.sh#!/bin/bash# Update timestampecho "Last updated: $(date)" >> docs/footer.md# Generate table of contentsfind docs/ -name "*.md" | sort > docs/TOC.md# Build static sitepandoc docs/*.md -o site/index.html --standalone# Deploy to serverrsync -av site/ user@server:/var/www/docs/EOF# Monitor file changes# Install inotify-tools firstsudo apt-get install inotify-tools# Watch and auto-rebuildinotifywait -m -e modify --format '%w%f' docs/*.md | while read file; do  echo "File $file changed, rebuilding..."  ./build.shdone

project-example.sh

# Setup project structuremkdir ai-project-docscd ai-project-docs# Create directory structuremkdir -p {docs/{api,tutorials,guides},scripts,templates}# Create main documentation filescat << 'EOF' > docs/README.md# AI Project Documentation## OverviewComplete documentation for AI programming projects.## Structure- [API Reference](api/README.md)- [Tutorials](tutorials/README.md)- [User Guides](guides/README.md)EOF# Create build configurationcat << 'EOF' > config.yamlinput_dir: docsoutput_dir: buildcss: templates/style.csstemplate: templates/default.htmlEOF# Create automated build scriptcat << 'EOF' > scripts/build-docs.sh#!/bin/bashCONFIG_FILE="config.yaml"INPUT_DIR=$(grep "input_dir:" $CONFIG_FILE | cut -d' ' -f2)OUTPUT_DIR=$(grep "output_dir:" $CONFIG_FILE | cut -d' ' -f2)echo "Building documentation from $INPUT_DIR to $OUTPUT_DIR"# Create output directorymkdir -p $OUTPUT_DIR# Convert all markdown filesfind $INPUT_DIR -name "*.md" -type f | while read file; do  rel_path=${file#$INPUT_DIR/}  output_file="$OUTPUT_DIR/${rel_path%.md}.html"  output_dir=$(dirname "$output_file")  mkdir -p "$output_dir"  pandoc "$file" -o "$output_file" --standalone  echo "✓ Converted: $file"doneecho "Documentation build completed!"EOFchmod +x scripts/build-docs.sh# Run the build./scripts/build-docs.sh