SDCStudio Obsidian Template

Create SDC4-compliant dataset descriptions with ease using Obsidian

An interactive Templater template and professional CSS theme for creating SDC4 (Semantic Data Charter) compliant dataset descriptions in Obsidian.

🚀 Quick Start

Install Prerequisites
- Obsidian v1.0.0+
- Templater Plugin v1.16.0+ (free community plugin)
Download Template
- Download latest release
- Or clone this repository
Install
- Copy templates/ObsidianDataSetTemplate.md to your vault's templates/ folder
- Copy snippets/sdcstudio-theme.css to your vault's .obsidian/snippets/ folder
- Enable CSS snippet in Obsidian Settings → Appearance → CSS Snippets
Use
- Create new note in Obsidian
- Run Templater: Insert template → ObsidianDataSetTemplate
- Follow the interactive prompts
- Upload resulting markdown to SDCStudio

📚 Full Installation Guide | 📖 Usage Guide | 🎨 Theme Guide

✨ Features

Interactive Template (v4.3.0)

✅ Quick / Guided mode - Choose your pace: ~15 prompts for Quick, full control in Guided
✅ Domain-aware defaults - Pick Healthcare, get "Patient" pre-filled; pick Government, get "Citizen"
✅ Subject / Provider / Participation - Model who the record is about, who provided it, and other parties
✅ User-friendly types - text, integer, decimal, boolean, date, datetime, identifier, email, url
✅ Component reuse - @ProjectName:ComponentLabel for NIEM, FHIR, HL7v3, openEHR
✅ Consolidated constraints - One prompt: No / Required / Required+Unique / Custom
✅ SDC4 named trees - Data, Subject, Provider, Participation, Workflow, Attestation, Audit, Links
✅ Unlimited loops - Add as many columns and participations as needed
✅ Clean output - Toast notifications for progress, no artifacts in the generated document

Professional Theme

✅ SDCStudio colors - Official design system (#0a2342, #2ca58d, #f0a500, #f7f9fb)
✅ Professional tables - Blue headers matching SDCStudio web app
✅ Special styling - Dataset columns and clusters get highlighted formatting
✅ Display-only - Does NOT modify your markdown files (safe for SDCStudio upload)
✅ WCAG compliant - Accessible colors and contrast ratios

📦 What's Included

SDCObsidianTemplate/
├── templates/
│   └── ObsidianDataSetTemplate.md    # Main Templater template (v4.3.0)
├── snippets/
│   └── sdcstudio-theme.css           # CSS theme for SDCStudio styling
├── docs/
│   ├── INSTALL.md                    # Installation guide
│   ├── USAGE.md                      # Usage guide with examples
│   └── THEME.md                      # Theme customization guide
├── LICENSE                           # Apache 2.0
└── README.md                         # This file

💡 Example Usage

Type Reference

Type You Write	Maps To SDC4	When to Use
`text`	XdString, XdToken	Free text, strings, categorical with enum
`integer`	XdCount, XdOrdinal, XdString	Whole numbers (add units for XdCount)
`decimal`	XdQuantity, XdFloat, XdDouble	Decimals (add units for XdQuantity)
`boolean`	XdBoolean	True/False, Yes/No
`date`	XdTemporal	Dates only (YYYY-MM-DD)
`datetime`	XdTemporal	Dates with time
`identifier`	XdString	IDs, codes, UUIDs
`email`	XdString (validated)	Email addresses
`url`	XdLink	Web links, URLs, URIs

Component Reuse

### Column: State
**ReuseComponent**: @NIEM:StateUSPostalServiceCode
**Type**: text
**Description**: US State postal code

### Column: PatientID
**ReuseComponent**: @HL7v3:PatientIdentifier
**Type**: identifier
**Description**: Unique patient identifier

🔄 Version History

v4.3.0 (2026-02-19) - Current

Align with SDC4 named trees

## Root Cluster: renamed to ## Data: to match SDC4 data model
Sub-clusters removed entirely — all sections are flat columns only
New optional sections: Workflow, Attestation, Audit, Links
All 8 SDC4 named trees supported

v4.2.0 (2026-02-15)

Complete UX redesign

Quick / Guided mode for controlling prompt depth
Domain-aware defaults for Subject, Provider, and cluster names
Single participation-scope decision replaces separate yes/no prompts
Toast notifications instead of comment-based progress markers
Unlimited column and participation loops
Consolidated constraint prompt
Clean, artifact-free output

v4.1.0 (2026-02-15)

Subject/Provider/Participation sections for SDC4 participation model
Function and Mode keywords for Participation sections

v4.0.1 (2025-11-03)

Documentation Enhancement

Added comprehensive KEYWORD_REFERENCE.md (430+ lines)
Complete documentation for all keywords and syntax
Aligned with SDCStudio keyword documentation
Added references in README, USAGE, and template

v4.0.0 (2025-11-02)

Major redesign fixing all v1.0 issues

Fixed:

❌ System hanging → ✅ Non-blocking prompts with visual feedback
❌ Limited to 2 columns → ✅ Unlimited scalability
❌ Confusing UX → ✅ Clear, guided workflow
❌ No component reuse → ✅ Full @ProjectName:ComponentLabel support
❌ Poor markdown structure → ✅ Spec-compliant output

New Features:

Component reuse from NIEM, FHIR, HL7v3, openEHR
User-friendly type system with SDC4 mapping
Complete YAML front matter
Structured constraints (YAML format)
LLM enrichment toggle
Copy-paste templates for scalability
SDCStudio design system theme

Breaking Changes: None (new major version)

Full Changelog

🛠️ Installation

Quick Install

Copy template file:

cp templates/ObsidianDataSetTemplate.md [your-vault]/templates/

Copy CSS theme:

cp snippets/sdcstudio-theme.css [your-vault]/.obsidian/snippets/

Configure Templater:
- Obsidian Settings → Templater
- Set "Template folder location" to templates
Enable CSS theme:
- Obsidian Settings → Appearance → CSS Snippets
- Toggle ON "sdcstudio-theme"

📚 Detailed Installation Guide

📖 Documentation

Installation Guide - Step-by-step setup instructions
Usage Guide - How to use the template with examples
Keyword Reference - Complete keyword documentation and syntax guide
Theme Guide - CSS theme setup and customization
Changelog - Version history and changes
Contributing - How to contribute to this project

🤝 Contributing

We welcome contributions! This project is part of Axius SDC, Inc.'s commitment to open source.

Ways to contribute:

🐛 Report bugs via GitHub Issues
💡 Suggest features or improvements
📝 Improve documentation
🔧 Submit pull requests

See CONTRIBUTING.md for guidelines.

🏢 About

Project Information

Maintained by: Axius SDC, Inc.
Part of: Semantic Data Charter ecosystem
Works with: SDCStudio v4.0.0+
License: Apache 2.0 (see LICENSE)

Related Projects

SDCStudio - Django application for creating SDC4 data models
Semantic Data Charter - Core SDC4 reference model
Axius SDC Website - Company website and resources

📊 Use Cases

Perfect for:

📊 Data Architects - Building SDC4-compliant schemas
🔬 Researchers - Documenting research datasets
🏥 Healthcare Teams - Creating clinical data models
💼 Enterprise Teams - Standardizing data documentation
🎓 Students - Learning semantic data modeling

🔗 Workflow

1. Create note in Obsidian
   ↓
2. Insert SDCStudio template
   ↓
3. Answer interactive prompts
   ↓
4. Review with beautiful styling
   ↓
5. Upload markdown to SDCStudio
   ↓
6. Generate XSD, XML, JSON, RDF, SHACL, GQL

⚙️ System Requirements

Obsidian: v1.0.0 or later
Templater Plugin: v1.16.0 or later (free)
Operating Systems: Windows, Mac, Linux
Disk Space: ~70 KB

🔒 Security & Privacy

✅ No telemetry - Template runs entirely locally
✅ No network calls - All processing in Obsidian
✅ No data collection - Your notes stay private
✅ Open source - Review the code yourself

📝 License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See LICENSE for full details.

🙏 Acknowledgments

Obsidian - For the amazing knowledge management platform
Templater - For the powerful template plugin
Semantic Data Charter - For the SDC4 reference model
All contributors and users who provide feedback and improvements

📞 Support

Documentation: Check the docs/ folder
Issues: GitHub Issues
Discussions: GitHub Discussions
Website: axius-sdc.github.io

🌟 Star This Repository

If you find this project useful, please consider giving it a ⭐️ on GitHub!

Made with ❤️ by Axius SDC, Inc.

Empowering semantic data modeling for everyone