docs(end-user): align user docs with 0.19 prefs and platform matrix by Jocs · Pull Request #4300 · marktext/marktext · GitHub
Skip to content

docs(end-user): align user docs with 0.19 prefs and platform matrix - #4300

Merged
Jocs merged 1 commit into
developfrom
docs/end-user-accuracy-pass
May 28, 2026
Merged

Jocs merged 1 commit into
developfrom
docs/end-user-accuracy-pass

Conversation

@Jocs

@Jocs Jocs commented May 28, 2026

Copy link
Copy Markdown
Member

Summary

Companion to #4299. Brings the end-user docs and the top-level README back in line with what 0.19 actually ships.

  • PREFERENCES.md — full rewrite against src/main/preferences/schema.json. Adds the keys that landed since the table was last touched (fileSortOrder, openedFilesInSidebar, wrapCodeBlocks, editorLineWidth, codeBlockLineNumbers, autoNormalizeLineEndings, isHtmlEnabled, isGitlabCompatibilityEnabled, followSystemTheme / lightModeTheme / darkModeTheme, restoreLayoutState, customCss, the spellchecker* trio, imageInsertAction and the image* relative-directory trio). Fixes stale defaults / enums (startUpAction default is restoreAll, fileSortBy default is modified, imageDropAction is now imageInsertAction).
  • IMAGE_UPLOADER_CONFIGRATION.md — strip the GitHub-uploader section. It was removed in refactor(image): remove GitHub uploader and None option; default to PicGo #4276; PicGo is the only built-in uploader now.
  • CLI.md — document the --disable-spellcheck flag.
  • FAQ.md — refresh the supported-platforms list (macOS 11+ x64/arm64, Windows 10/11 x64/arm64 after the Windows arm64 build in build: add Windows ARM64 native build support #4279) and fix a broken developer-docs link.
  • THEMES.md — explain that the menu labels map to different ids in preferences.json (e.g. Cadmium Light → light) and fix the materal-dark.png typo in the screenshot table.
  • ENVIRONMENT.md — drop the no-longer-used MARKTEXT_DEV_HIDE_BROWSER_ANALYZER row.
  • BASICS.md — note the new collapsible Opened Files subsection in the sidebar (toggle via openedFilesInSidebar, feat(sidebar): add toggle to hide Opened Files + cap list to 4 items #4278).
  • docs/README.md — add a link to IMAGES.md.
  • README.md — refresh the platform badge and the macOS / Windows install sections so they describe the actual installer file names and reflect the Windows arm64 build.

Test plan

  • Skim the rendered Markdown on GitHub for layout regressions
  • Schema↔doc parity (should print empty sets):
    ```bash
    python3 -c "import json,re;s=set(json.load(open('src/main/preferences/schema.json')).keys());d=set(re.findall(r'\\| (\\w+) +\\|', open('docs/end-user/PREFERENCES.md').read()))-{'Default','Key'};print(sorted(s-d), sorted(d-s))"
    ```
  • `rg 'imageDropAction|MARKTEXT_DEV_HIDE_BROWSER_ANALYZER|materal-dark' docs/ README.md` returns nothing
  • `ls docs/themeImages/material-dark.png` exists

🤖 Generated with Claude Code

- PREFERENCES.md: full rewrite against src/main/preferences/schema.json.
  Adds the keys that landed since the table was last touched
  (fileSortOrder, openedFilesInSidebar, wrapCodeBlocks, editorLineWidth,
  codeBlockLineNumbers, autoNormalizeLineEndings, isHtmlEnabled,
  isGitlabCompatibilityEnabled, followSystemTheme/lightModeTheme/
  darkModeTheme, restoreLayoutState, customCss, spellchecker* trio,
  imageInsertAction + image* relative-directory trio). Fixes a few
  stale defaults/enums (startUpAction default is `restoreAll`,
  fileSortBy default is `modified`, `imageDropAction` was renamed to
  `imageInsertAction`).
- IMAGE_UPLOADER_CONFIGRATION.md: strip the GitHub uploader section —
  it was removed in #4276; PicGo is now the only built-in uploader.
- CLI.md: document the `--disable-spellcheck` flag.
- FAQ.md: refresh the supported-platforms list (macOS 11+, Windows
  10/11, both x64 and arm64 for mac and Windows after #4279) and fix
  a broken developer-docs link.
- THEMES.md: explain that the labels in the Theme menu map to
  different ids in `preferences.json` (Cadmium Light → `light`, etc.),
  and fix the `materal-dark.png` typo in the screenshot table.
- ENVIRONMENT.md: drop the no-longer-used
  `MARKTEXT_DEV_HIDE_BROWSER_ANALYZER` row (removed during the
  electron-vite migration).
- BASICS.md: note that the file tree now hosts a collapsible
  Opened Files subsection toggled via `openedFilesInSidebar` (#4278).
- docs/README.md: add a link to IMAGES.md (it existed but wasn't
  surfaced from the end-user index).
- README.md: refresh the platform badge and the macOS / Windows
  install sections so they describe the actual installer file names
  (`marktext-mac-(x64|arm64)-%version%.dmg`,
   `marktext-win-(x64|arm64)-%version%-setup.exe`) and reflect the
  Windows arm64 build added in #4279.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 28, 2026 15:49

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation-only refresh that brings the end-user docs and top-level README in sync with what MarkText 0.19 actually ships: new/changed preference keys and defaults, removal of the GitHub uploader, addition of the --disable-spellcheck CLI flag, updated supported-platform list, theme label↔id clarification, sidebar Opened Files note, and updated install instructions reflecting the new Windows arm64 build (#4279).

Changes:

  • Full rewrite of PREFERENCES.md against src/main/preferences/schema.json (new keys, corrected defaults like startUpAction=restoreAll, fileSortBy=modified, rename imageDropAction → imageInsertAction, plus Spelling/Image/Custom CSS sections).
  • Refresh of IMAGE_UPLOADER_CONFIGRATION.md, FAQ.md, ENVIRONMENT.md, CLI.md, THEMES.md, BASICS.md, docs/README.md to reflect removed/added features.
  • README install sections updated for macOS 11+ arm64/x64 and Windows 10/11 arm64/x64 installer file names.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Platform badge + macOS/Windows install instructions updated for arm64 installers and OS minimums.
docs/README.md Adds link to IMAGES.md.
docs/end-user/PREFERENCES.md Full rewrite mirroring schema.json; new defaults, enums, and Spelling/Image/Custom CSS/Watcher tables.
docs/end-user/IMAGE_UPLOADER_CONFIGRATION.md Removes GitHub uploader section; clarifies PicGo is the sole built-in uploader.
docs/end-user/FAQ.md Updates supported-platforms list; fixes broken dev-docs link path.
docs/end-user/ENVIRONMENT.md Drops the removed MARKTEXT_DEV_HIDE_BROWSER_ANALYZER row.
docs/end-user/CLI.md Documents the --disable-spellcheck flag.
docs/end-user/THEMES.md Adds label↔id mapping note; fixes materal-dark.png → material-dark.png typo.
docs/end-user/BASICS.md Notes the new collapsible Opened Files sidebar subsection and the openedFilesInSidebar preference.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions

Copy link
Copy Markdown
Contributor

Build artifacts for PR #4300:

Run: https://github.com/marktext/marktext/actions/runs/26585672661

Artifact Size Link
marktext-linux 594.3 MB Download
marktext-windows-arm64 271.4 MB Download
marktext-windows-x64 272.7 MB Download
marktext-macos-x64 272.5 MB Download
marktext-macos-arm64 262.3 MB Download

@Jocs
Jocs merged commit bcc8270 into develop May 28, 2026
11 checks passed
@Jocs
Jocs deleted the docs/end-user-accuracy-pass branch May 28, 2026 16:14
thimbleberrysystems pushed a commit to thimbleberrysystems/WordBird that referenced this pull request Jun 21, 2026
…arktext#4300)

- PREFERENCES.md: full rewrite against src/main/preferences/schema.json.
  Adds the keys that landed since the table was last touched
  (fileSortOrder, openedFilesInSidebar, wrapCodeBlocks, editorLineWidth,
  codeBlockLineNumbers, autoNormalizeLineEndings, isHtmlEnabled,
  isGitlabCompatibilityEnabled, followSystemTheme/lightModeTheme/
  darkModeTheme, restoreLayoutState, customCss, spellchecker* trio,
  imageInsertAction + image* relative-directory trio). Fixes a few
  stale defaults/enums (startUpAction default is `restoreAll`,
  fileSortBy default is `modified`, `imageDropAction` was renamed to
  `imageInsertAction`).
- IMAGE_UPLOADER_CONFIGRATION.md: strip the GitHub uploader section —
  it was removed in marktext#4276; PicGo is now the only built-in uploader.
- CLI.md: document the `--disable-spellcheck` flag.
- FAQ.md: refresh the supported-platforms list (macOS 11+, Windows
  10/11, both x64 and arm64 for mac and Windows after marktext#4279) and fix
  a broken developer-docs link.
- THEMES.md: explain that the labels in the Theme menu map to
  different ids in `preferences.json` (Cadmium Light → `light`, etc.),
  and fix the `materal-dark.png` typo in the screenshot table.
- ENVIRONMENT.md: drop the no-longer-used
  `MARKTEXT_DEV_HIDE_BROWSER_ANALYZER` row (removed during the
  electron-vite migration).
- BASICS.md: note that the file tree now hosts a collapsible
  Opened Files subsection toggled via `openedFilesInSidebar` (marktext#4278).
- docs/README.md: add a link to IMAGES.md (it existed but wasn't
  surfaced from the end-user index).
- README.md: refresh the platform badge and the macOS / Windows
  install sections so they describe the actual installer file names
  (`marktext-mac-(x64|arm64)-%version%.dmg`,
   `marktext-win-(x64|arm64)-%version%-setup.exe`) and reflect the
  Windows arm64 build added in marktext#4279.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants