@mdwrk/mdwrkcom-content-pack 0.1.5

package/data/markdown/docs/usage/editor-basics.md

@@ -0,0 +1,138 @@
+---
+title: Editor Basics
+slug: usage/editor-basics
+section: Features
+sectionOrder: 2
+order: 1
+toc: true
+date: 2026-05-03
+status: published
+author: CobyCloud
+displayAuthor: false
+excerpt: MdWrk combines a markdown source editor, split preview workflow, table builder, formatting toolbar, and local-first workspace model so drafting stays fast without hiding the underlying Markdown.
+---
+
+## What the Editor Is For
+
+MdWrk is built for direct Markdown authoring with immediate visual feedback. The editor stays plain-text first, but it removes a lot of the friction that usually makes Markdown feel slower than rich-text tools.
+
+The client combines `@mdwrk/markdown-editor-react` for source editing and `@mdwrk/markdown-renderer-react` for preview, so writing and reading stay in the same workspace flow.
+
+## Core Writing Views
+
+MdWrk supports three primary work modes:
+
+- editor-only for focused drafting
+- split view for writing while checking rendered output
+- preview-only for review, presentation, and export inspection
+
+Split view includes a draggable divider and keyboard-adjustable separator so the balance between source and preview can be changed without leaving the work surface.
+
+## Source Editing Features
+
+The editor surface currently provides:
+
+- controlled and uncontrolled document modes
+- live cursor and selection tracking
+- line-number gutter support
+- undo and redo history
+- keyboard shortcut support
+- toolbar command execution
+- selection-aware formatting state for bold, italic, strikethrough, bullet lists, and task lists
+
+The result is a Markdown editor that still behaves like a real text editor instead of a fragile overlay on top of rich text.
+
+## Formatting Toolbar
+
+The default work-pane toolbar exposes direct authoring controls for:
+
+- bold
+- italic
+- strikethrough
+- bullet lists
+- task lists
+- indent
+- outdent
+- inline math
+- footnotes
+- superscript
+- subscript
+- undo
+- redo
+- insert table
+
+MdWrk writes Markdown for these actions instead of storing proprietary formatting state.
+
+## Keyboard Behavior
+
+The editor adds a few opinionated behaviors that improve drafting speed:
+
+- `Ctrl/Cmd+B` applies bold markers
+- `Ctrl/Cmd+I` applies italic markers
+- `Ctrl/Cmd+Shift+X` applies strikethrough markers
+- `Ctrl/Cmd+Z` and `Ctrl/Cmd+Shift+Z` drive undo and redo
+- `Tab` indents the current line or selected block
+- `Shift+Tab` outdents the current line or selected block
+- `Enter` continues unordered, ordered, and task lists
+- `Enter` on an empty list item exits the list cleanly
+
+These behaviors are especially useful for notes, checklists, changelogs, and long structured documents.
+
+## Table Builder
+
+MdWrk includes a table builder in the work-pane toolbar. Instead of hand-building the first pipe grid, you can choose row and column counts and insert a ready-to-edit Markdown table.
+
+```markdown
+| Column 1 | Column 2 | Column 3 |
+| --- | --- | --- |
+| R1C1 | R1C2 | R1C3 |
+| R2C1 | R2C2 | R2C3 |
+```
+
+After insertion, the table remains ordinary Markdown and can be edited anywhere.
+
+## Workspace Model
+
+Documents live in browser-managed local storage unless you intentionally connect another surface such as GitHub sync or export. This keeps drafting private by default and lets the editor continue working when network access is unavailable.
+
+Common workspace operations include:
+
+- creating files and folders
+- renaming entries
+- deleting obsolete content
+- switching between projects
+- keeping multiple Markdown documents available for internal linking and navigation
+
+## Theme and Layout Behavior
+
+The editor follows the shared viewport and aspect-ratio contract used across the workspace. Themes can style each breakpoint band differently, but the editing and preview layout rules stay predictable across portrait, square, landscape, wide, and ultra-wide usage.
+
+## Why This Matters
+
+MdWrk is not trying to hide Markdown behind a fake document model. The product goal is to make Markdown fast enough for daily writing while keeping the file portable, inspectable, and easy to move into GitHub, static documentation, package READMEs, or other publishing surfaces.
+
+## Related Docs
+
+- [Advanced Markdown Formatting](/features/advanced-formatting)
+- [Rendering And Preview](/features/rendering-and-preview)
+- [Client Configuration](/docs/getting-started/configuration)
+
+## Quick Reference
+
+Use this article to understand Editor Basics in the MdWrk Product surface. MdWrk combines a markdown source editor, split preview workflow, table builder, formatting toolbar, and local-first workspace model so drafting stays fast without hiding the underlying Markdown.
+
+Key concepts covered here:
+
+- local Markdown files
+- live preview
+- workspace organization
+- privacy-first storage
+- theme portability
+
+Useful follow-up pages:
+
+- [Local-First Markdown Workspace](/features/local-first-markdown-workspace)
+- [Markdown Preview Editor](/features/markdown-preview-editor)
+- [Editor Basics](/features/editor-basics)
+
+Use this page when you want the current MdWrk editor surface, not just the package names behind it.

package/data/markdown/docs/usage/rendering-and-preview.md

@@ -0,0 +1,157 @@
+---
+title: Rendering and Preview
+slug: usage/rendering-and-preview
+section: Features
+sectionOrder: 2
+order: 3
+toc: true
+date: 2026-05-03
+status: published
+author: CobyCloud
+displayAuthor: false
+excerpt: MdWrk turns Markdown into a live rendered preview with internal-link navigation, profile-aware HTML handling, policy advisories, and export paths that stay aligned with the on-screen renderer.
+---
+
+## Live Preview Surface
+
+MdWrk renders Markdown live inside the workspace so you can validate structure, spacing, tables, code blocks, task lists, and links while you write.
+
+The preview surface is available in:
+
+- split view beside the editor
+- preview-only mode for reading and review
+- export and print-oriented output flows
+- lander documentation pages that reuse the same renderer family
+
+## Shared Renderer Contract
+
+MdWrk uses `@mdwrk/markdown-renderer-react` on top of `@mdwrk/markdown-renderer-core`. The renderer converts Markdown into semantic HTML and keeps the same baseline formatting contract across product surfaces.
+
+That shared contract includes:
+
+- headings and heading extraction
+- paragraphs and inline emphasis
+- links and images
+- blockquotes
+- ordered, unordered, and task lists
+- tables
+- fenced code blocks
+- optional profile features such as footnotes, math, superscript, and subscript when enabled
+
+## Internal Markdown Navigation
+
+The workspace preview is not a dead render.
+
+Internal Markdown links can resolve against the current workspace file set. That means preview links can:
+
+- jump to a heading in the current document
+- navigate to another Markdown file in the same workspace
+- carry a pending hash so the destination preview scrolls to the intended section
+
+This makes larger doc sets and linked note collections much easier to review without leaving the preview surface.
+
+## Preview Policy and HTML Handling
+
+Preview behavior is profile-aware.
+
+MdWrk resolves HTML handling separately for preview and export so the product can show a clear policy instead of silently widening the trust boundary.
+
+The current HTML handling modes are:
+
+- `escape`
+- `sanitize`
+- `allow-trusted`
+
+When preview policy warnings are relevant, the preview surface can show an advisory panel that summarizes the current HTML handling mode and any active profile warnings.
+
+## Optional Profiles in Preview
+
+The renderer respects the workspace Markdown profile configuration. That means the preview surface can reflect:
+
+- footnotes
+- definition lists
+- math structures
+- superscript
+- subscript
+- smart punctuation
+- experimental profiles such as citations or markdown-in-html when explicitly enabled
+
+This keeps preview behavior aligned with the configured document contract instead of guessing.
+
+## Preview Actions
+
+The workspace preview can expose direct output actions without leaving the rendered surface:
+
+- HTML export
+- print preview
+
+These actions are available as overlay controls on the preview pane when the surrounding shell wires them in.
+
+## HTML Export Alignment
+
+MdWrk's HTML export is generated from the same rendering pipeline used for preview. That matters because the exported document is meant to look and behave like the preview you already approved.
+
+The export flow currently includes:
+
+- the active Markdown profile configuration
+- profile-aware HTML handling
+- advisory messaging when preview/export policy matters
+- theme-aware styling
+- configurable background mode
+- print-oriented page styling
+
+This keeps export from becoming a separate undocumented renderer with different results.
+
+## Print and PDF-Oriented Output
+
+MdWrk's export styles include print-specific controls for page shape and long-form document behavior.
+
+Current output rules include:
+
+- A4 portrait or landscape orientation
+- explicit page margins
+- print font size and line-height tokens
+- heading keep-with-next behavior
+- page-break helper hooks for Markdown-rendered content
+
+These controls make the rendered output more useful for documentation reviews, handoffs, and printable deliverables.
+
+## Theme-Aware Rendering
+
+Preview and export styling are theme-aware. MdWrk bridges shared tokens into the renderer so Markdown surfaces inherit the active workspace language instead of feeling visually detached from the rest of the product.
+
+That includes:
+
+- foreground and muted text colors
+- code block colors
+- table header and row styling
+- blockquote treatment
+- print/export background choices
+
+## Why This Matters
+
+MdWrk treats rendering as a first-class product surface, not as a best-effort convenience after editing. The preview is where document structure, links, and export readiness become visible, so it needs to stay trustworthy and aligned with the actual file.
+
+## Related Docs
+
+- [Editor Basics](/features/editor-basics)
+- [Advanced Markdown Formatting](/features/advanced-formatting)
+- [Client Configuration](/docs/getting-started/configuration)
+
+## Quick Reference
+
+Use this article to understand Rendering and Preview in the MdWrk Product surface. MdWrk turns Markdown into a live rendered preview with internal-link navigation, profile-aware HTML handling, policy advisories, and export paths that stay aligned with the on-screen renderer.
+
+Key concepts covered here:
+
+- live preview
+- workspace organization
+- theme portability
+
+Useful follow-up pages:
+
+- [Local-First Markdown Workspace](/features/local-first-markdown-workspace)
+- [Markdown Preview Editor](/features/markdown-preview-editor)
+- [Editor Basics](/features/editor-basics)
+
+Use this page when you want the current MdWrk rendering contract across preview, navigation, HTML export, and print-oriented output.

package/data/markdown/docs/usage/text-wrap-previewer.md

@@ -0,0 +1,45 @@
+---
+title: Text Wrap Previewer
+slug: usage/text-wrap-previewer
+section: Features
+sectionOrder: 2
+order: 7
+toc: true
+date: 2026-05-06
+status: published
+author: CobyCloud
+displayAuthor: false
+excerpt: Text wrap previewer documents how MdWrk keeps source wrapping, preview wrapping, and line-number rhythm readable across pane sizes.
+---
+
+## What Text Wrap Previewer Covers
+
+The text wrap previewer is the user-facing contract for readable long-form Markdown. It covers how source text wraps in the editor, how rendered Markdown wraps in preview, and how line numbers stay aligned when long source lines occupy multiple visual rows.
+
+## Source Editor Wrapping
+
+The source editor uses soft wrapping so files remain portable and line endings are not rewritten just to fit the pane. The editor estimates visual rows from the active text width and keeps the line-number gutter aligned with wrapped rows.
+
+## Preview Wrapping
+
+The preview pane uses the shared Markdown typography styles from the UI token layer. Paragraphs, code-adjacent prose, tables, and task lists should remain readable without forcing horizontal page scroll for normal prose.
+
+## Split View Behavior
+
+In split view, source and preview wrapping respond to the available pane width. The divider can change the wrapping context without changing the saved Markdown content.
+
+## Practical Use
+
+Use text wrap previewing when writing:
+
+- long documentation pages
+- checklist-heavy release notes
+- narrow portrait-mode drafts
+- split-pane review notes
+- Markdown intended for static publishing
+
+## Related Docs
+
+- [Editor Basics](/features/editor-basics)
+- [Rendering And Preview](/features/rendering-and-preview)
+- [UIX Responsive Contract](/features/uix-responsive-contract/)

package/data/markdown/docs/usage/ui-refresh-1-3-28.md

@@ -0,0 +1,43 @@
+---
+title: UI Refresh 1.3.28
+slug: archive/ui-refresh-1-3-28
+section: Archive
+sectionOrder: 6
+order: 25
+toc: true
+date: 2026-05-02
+status: published
+author: CobyCloud
+excerpt: MdWrk 1.3.28 improves editing ergonomics, toolbar grouping, markdown list rendering, status footer behavior, and workspace action placement.
+---
+
+## Client update: `mdwrk/mdwrkspace` 1.3.28
+
+This release improves editing ergonomics and cleans up key UI surfaces:
+
+- Improved view-toolbar formatting grouping with a dedicated strikethrough convenience control.
+- Nested markdown list marker rendering now shows only the deepest visible marker.
+- Project selector cleanup and stronger border treatment for project/theme controls.
+- Project delete confirmation modal upgraded for readability and action clarity.
+- System Configuration modal sizing and spacing refined.
+- System Configuration tab/pane labeling de-duplicated.
+- Key mapping cards updated so command purpose + key binding remain legible at narrow widths.
+
+## Notes
+
+The viewport contract remains centralized in `apps/client/styles/base/viewports.css`; themes continue to style each breakpoint band independently.
+
+## Quick Reference
+
+Use this article to understand UI Refresh 1.3.28 in the MdWrk Archive surface. UI Refresh 1.3.28 explains how this MdWrk surface works in the current client and package system.
+
+Key concepts covered here:
+
+- theme portability
+- developer package reuse
+
+Useful follow-up pages:
+
+- [Theme Packs](/features/theme-packs)
+- [Advanced Markdown Formatting](/features/advanced-formatting)
+- [Client Installation](/docs/getting-started/installation)

package/data/markdown/docs/usage/ui-refresh-1-3-29.md

@@ -0,0 +1,44 @@
+---
+title: UI Refresh 1.3.29
+slug: archive/ui-refresh-1-3-29
+section: Archive
+sectionOrder: 6
+order: 26
+toc: true
+date: 2026-05-02
+status: published
+author: CobyCloud
+excerpt: This release focuses on visual clarity, modal usability, and responsive behavior improvements-
+---
+
+## Client update: `mdwrk/mdwrkspace` 1.3.29
+
+This release focuses on visual clarity, modal usability, and responsive behavior improvements:
+
+- Added a dedicated strikethrough convenience button in the view toolbar controls.
+- Fixed nested list marker rendering so only the deepest list item marker is shown.
+- Project selector border treatments were tightened for clearer control boundaries.
+- Theme selector now surfaces the project title context while preserving theme iconography.
+- Project delete confirmation modal readability and hierarchy were enhanced.
+- System Configuration modal dimensions were increased for better fit on large and medium screens.
+- Reduced redundant system tab labeling and improved overall tab readability.
+- Key mapping cards were updated to prevent text overlap between command labels and key bindings.
+
+## Notes
+
+Viewport and aspect-ratio breakpoints remain centralized in `apps/client/styles/base/viewports.css`.
+
+## Quick Reference
+
+Use this article to understand UI Refresh 1.3.29 in the MdWrk Archive surface. UI Refresh 1.3.29 explains how this MdWrk surface works in the current client and package system.
+
+Key concepts covered here:
+
+- theme portability
+- developer package reuse
+
+Useful follow-up pages:
+
+- [Theme Packs](/features/theme-packs)
+- [Client Installation](/docs/getting-started/installation)
+- [Editor Basics](/features/editor-basics)

package/data/markdown/docs/usage/view-toolbar.md

@@ -0,0 +1,47 @@
+---
+title: View Toolbar
+slug: usage/view-toolbar
+section: Features
+sectionOrder: 2
+order: 8
+toc: true
+date: 2026-05-06
+status: published
+author: CobyCloud
+displayAuthor: false
+excerpt: View toolbar documents the MdWrk controls for switching editor, split, and preview modes while keeping export and formatting actions discoverable.
+---
+
+## Toolbar Purpose
+
+The view toolbar gives writers direct control over the active document surface. It keeps source editing, split preview, preview-only review, formatting commands, export actions, and table insertion close to the document.
+
+## View Modes
+
+MdWrk supports three primary document modes:
+
+- editor
+- split
+- preview
+
+Switching modes changes the visible panes without changing the Markdown document.
+
+## Authoring Actions
+
+The toolbar exposes common Markdown commands for formatting and document structure. These actions write Markdown syntax through the editor command model, which keeps the file portable.
+
+Common commands include bold, italic, strikethrough, bullet list, task list, indent, outdent, inline math, footnote, superscript, subscript, undo, redo, and table insertion.
+
+## Export Actions
+
+The toolbar also provides Markdown export, HTML export, and print preview entry points. Export behavior uses the active document and current preview policy rather than a separate document model.
+
+## Responsive Behavior
+
+The toolbar must remain usable in narrow and portrait contexts. Controls can scroll or condense, but they should not cover the editor, preview, or modal content.
+
+## Related Docs
+
+- [Editor Basics](/features/editor-basics)
+- [Text Wrap Previewer](/features/text-wrap-previewer/)
+- [UIX Responsive Contract](/features/uix-responsive-contract/)

package/data/markdown/legal/privacy.md

@@ -0,0 +1,21 @@
+---
+title: Privacy Policy
+date: 2026-05-02
+status: published
+author: CobyCloud
+lastUpdated: 2024-05-20
+---
+# Privacy Policy
+
+At **MdWrk**, we believe privacy is a fundamental human right. Our software is designed so that your data never touches our servers.
+
+## 1. Data Collection
+We do not collect, store, or process any of your personal data. All markdown files created in the application are stored locally in your browser's IndexedDB.
+
+## 2. Encryption
+While data is local, we support client-side encryption for sensitive documents.
+- **Algorithm**: AES-256-GCM
+- **Key Storage**: Never stored, derived from your password.
+
+## 3. GitHub Integration
+If you choose to sync with GitHub, the application uses your Personal Access Token (PAT) to communicate directly with the GitHub API. This token is stored locally and never sent to our servers.

package/data/markdown/legal/terms.md

@@ -0,0 +1,19 @@
+---
+title: Terms of Service
+date: 2026-05-02
+status: published
+author: CobyCloud
+lastUpdated: 2024-05-20
+---
+# Terms of Service
+
+Welcome to MdWrk. By using this application, you agree to the following:
+
+## 1. "As-Is" Software
+MdWrk is provided "as is" without any warranties.
+
+## 2. Ownership
+You own 100% of the content you create.
+
+## 3. Compliance
+MdWrk is intended for lawful use only. Users are responsible for their own data backups.