Aksara Writer - VS Code Extension
Modern markdown converter with Indonesian business templates for VS Code
Transform your markdown documents into professional PDF, HTML, and PowerPoint presentations with Aksara Writer - the document creator designed specifically for Indonesian businesses.
🚀 Features
- 📄 Multiple Export Formats: Convert markdown to PDF, HTML, and PPTX
- 🇮🇩 Indonesian Business Focus: Templates designed for local business needs
- 👁️ Live Preview: Real-time preview of your documents
- 📝 Business Templates: Invoice, Proposal, Report, Contract, and more
- 🎨 Professional Themes: Multiple themes for different document types
- ⚡ One-Click Access: Marp-style single button for all actions
📦 Installation
Prerequisites
Install Aksara Writer CLI globally:
npm install -g aksara-writer
Verify installation:
aksara-writer --help
Extension Installation
- Download the
.vsix file from the releases page
- Open VS Code
- Press
Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
- Type "Extensions: Install from VSIX"
- Select the downloaded
.vsix file
🎯 Usage
Getting Started
- Open a Markdown File: Create or open any
.md file in VS Code
- Access Aksara Writer: Click the "Aksara Writer" button in the editor toolbar (▶️ icon)
- Choose Action: Select from the menu:
- 👁️ Preview Document - Live HTML preview
- 📄 Export to PDF - Generate PDF document
- 📊 Export to PowerPoint - Create PPTX presentation
- 🌐 Export to HTML - Generate HTML file
- 📝 Insert Template - Add business templates
- 🎨 Change Theme - Select document theme
Aksara Directives
Use special directives in your markdown to control document appearance:
<!--
aksara:true
type: presentation
size: 16:9
meta:
title: My Presentation
subtitle: Professional Document
header: |  | Company Name | 2025 |
footer: © 2025 Your Company - Confidential
background: ./background.jpg
-->
# Your Content Here
Available Templates
- 📄 Default - Dokumen Umum
- 🧾 Invoice - Faktur Penjualan
- 📋 Proposal - Proposal Bisnis
- 📊 Report - Laporan Bisnis
- 📝 Contract - Kontrak Legal
- 📮 Letter - Surat Resmi
Themes
- 🏢 Default - Indonesian Business
- ✨ Minimal - Clean Design
- 🏛️ Corporate - Formal Corporate
- 🏛️ Government - Government Official
📸 Screenshots
Command Palette
Live Preview
⚙️ Configuration
Access settings via File > Preferences > Settings and search for "Aksara":
- Default Locale:
id (Indonesian) or en (English)
- Default Theme: Document theme selection
- Default Page Size: A4, Letter, or Legal
- Auto Preview: Automatically show preview for markdown files
🔧 Troubleshooting
Common Issues
Q: "Command not found: aksara-writer" error when using commands
- A: Ensure you have installed the CLI globally with
npm install -g aksara-writer and that your PATH includes npm global binaries
Q: Preview not updating
- A: Save your markdown file first, then try the preview again
Q: Export fails
- A: Check that your markdown file is saved and contains valid Aksara directives
Getting Help
🤝 Contributing
Aksara Writer is part of the Ak'sara Initiative - advancing Indonesia's digital literacy.
Ways to Contribute
- Report Bugs: Found an issue? Report it here
- Feature Requests: Have ideas? Share them with us
- Code Contributions: Fork the repo and submit pull requests
- Templates: Create Indonesian business templates
- Translations: Help localize for different regions
Development
# Clone and setup
git clone https://github.com/ak-sara/aksara-writer.git
cd aksara-writer/packages/vscode
# Install dependencies
bun install
# Build extension
bun run build
# Package extension
bun run package
📄 License
BSD-3-Clause License - see LICENSE file for details.
🌟 About Ak'sara Initiative
Ak'sara, draws from the Sanskrit word for "character" or "alphabet," which holds a deep connection to Indonesian culture. We believe that just as every story is built from individual letters, the best applications are crafted from well-written code.
Our philosophy is simple: we compose, not just code. Like the ancient scripts of the Nusantara archipelago, each line of code is a fundamental character, which, when thoughtfully arranged, forms a powerful instruction that brings visions to life.
Our Projects
- Aksara Writer - Document creator for businesses
- Aksara IS - No-code application builder (Svelte)
- Personal AI Assistant - Offline AI assistant (Tauri + Rust)
- MerdekaOS - Arch-based Linux distribution
Learn more: ak-sara.github.io
Made with ❤️ for Indonesian businesses by the Ak'sara Initiative
